Esquema de informações para bancos de dados com dialeto GoogleSQL

O esquema de informações é um esquema integrado comum a todos os bancos de dados do Spanner. É possível executar consultas SQL em tabelas no INFORMATION_SCHEMA para buscar metadados de esquema para um banco de dados.

Por exemplo, a consulta a seguir busca os nomes de todas as tabelas definidas pelo usuário em um banco de dados:

  SELECT
    table_schema,
    table_name
  FROM
    information_schema.tables
  WHERE
    table_schema NOT IN ('information_schema', 'SPANNER_SYS')
    AND table_type = 'BASE TABLE'

Os usuários do controle de acesso refinado veem resultados filtrados para algumas tabelas INFORMATION_SCHEMA, dependendo da função deles no banco de dados. Para mais informações, consulte Sobre o controle de acesso detalhado.

Uso

As tabelas INFORMATION_SCHEMA estão disponíveis apenas por interfaces SQL. Por exemplo:

  • A API executeQuery
  • O comando gcloud spanner databases execute-sql
  • A página Spanner Studio de um banco de dados no console Google Cloud

Outros métodos de leitura única não são compatíveis com INFORMATION_SCHEMA.

Outras observações sobre o uso do INFORMATION_SCHEMA:

Filtragem de linhas em tabelas information_schema

Principais com permissões do IAM no nível do banco de dados e principais que receberam acesso à função do sistema spanner_info_reader (ou a membros dessa função) podem ver todas as linhas em todas as tabelas information_schema. Para outros principais, em algumas tabelas, as linhas são filtradas com base na função atual do banco de dados. As descrições de tabela e visualização nas seções a seguir indicam como a filtragem de linhas é aplicada a cada tabela e visualização.

Tabelas em INFORMATION_SCHEMA

As seções a seguir descrevem as tabelas em INFORMATION_SCHEMA para bancos de dados do dialeto GoogleSQL.

SCHEMATA

A tabela INFORMATION_SCHEMA.SCHEMATA lista os esquemas no banco de dados. Eles incluem o esquema de informações e os esquemas nomeados, que contêm as tabelas que você define.

Nome da coluna Tipo Descrição
CATALOG_NAME STRING O nome do catálogo. Esta coluna existe para compatibilidade com tabelas de esquema de informações padrão do SQL. Essa coluna é sempre uma string vazia.
SCHEMA_NAME STRING O nome do esquema. É um nome para esquemas nomeados ou "" para o esquema padrão.
PROTO_BUNDLE STRING Se o banco de dados contiver instruções de pacote proto, essa coluna vai fornecer informações sobre o pacote usado no esquema. Essa coluna é NULL se não houver um pacote de proto no banco de dados.

DATABASE_OPTIONS

Esta tabela lista as opções definidas no banco de dados.

Nome da coluna Tipo Descrição
CATALOG_NAME STRING O nome do catálogo. É sempre uma string vazia.
SCHEMA_NAME STRING O nome do esquema. É uma string vazia se não tiver nome.
OPTION_NAME STRING O nome da opção de banco de dados.
OPTION_TYPE STRING O tipo de dados da opção de banco de dados.
OPTION_VALUE STRING O valor da opção do banco de dados.

PLACEMENTS

Esta tabela lista as posições no banco de dados.

Nome da coluna Tipo Descrição
PLACEMENT_NAME STRING É o nome da posição.
IS_DEFAULT BOOL Um booleano que indica se a posição é a padrão.

PLACEMENT_OPTIONS

Para cada posição, esta tabela lista as opções definidas na posição na cláusula OPTIONS da instrução CREATE PLACEMENT.

Os valores válidos para OPTION_NAME incluem:

  • instance_partition
  • default_leader
Nome da coluna Tipo Descrição
PLACEMENT_NAME STRING É o nome da posição.
OPTION_NAME STRING O nome da opção de posição.
OPTION_TYPE STRING O tipo de dados da opção de veiculação. Para as duas opções, é STRING(MAX).
OPTION_VALUE STRING O valor da opção de posição. Para instance_partition, esse é o nome da partição de instância. Para default_leader, é o nome da região líder padrão.

LOCALITY_GROUP_OPTIONS

Para cada grupo de localidades, essa tabela lista o nome e as opções definidas na cláusula OPTIONS da instrução CREATE LOCALITY GROUP.

Nome da coluna Tipo Descrição
LOCALITY_GROUP_NAME STRING O nome do grupo de localidades.
OPTION_NAME STRING O nome da opção de grupo de localidades. As opções válidas são:
  • STORAGE: define o tipo de armazenamento do grupo de localidade.
  • SSD_TO_HDD_SPILL_TIMESPAN: define por quanto tempo os dados são armazenados em SSD antes de serem movidos para HDD.
OPTION_VALUE STRING O valor da opção do grupo de localidades. Para STORAGE, isso é ssd ou hdd. Para SSD_TO_HDD_SPILL_TIMESPAN, esse é o período em que os dados precisam ser armazenados em SSD antes de serem movidos para o armazenamento HDD. Por exemplo, 10d é 10 dias. O período mínimo que você pode definir é de uma hora.

TABLES

Essa tabela filtrada por linha lista as tabelas e visualizações no banco de dados. Os principais com permissões do IAM no nível do banco de dados e os principais que receberam acesso à função de sistema spanner_info_reader ou aos membros dessa função podem ver todas as linhas nessa visualização. Todos os outros principais só podem ver tabelas que atendam a um dos seguintes requisitos:

  • Os privilégios de controle de acesso refinado SELECT, INSERT, UPDATE ou DELETE são concedidos na tabela ao papel atual do banco de dados, aos papéis de que o papel atual do banco de dados é membro ou a public.
  • Os privilégios SELECT, INSERT ou UPDATE são concedidos em qualquer coluna de tabela à função atual do banco de dados, às funções de que a função atual do banco de dados é membro ou a public.
Nome da coluna Tipo Descrição
TABLE_CATALOG STRING Não utilizado. É sempre uma string vazia.
TABLE_SCHEMA STRING O nome do esquema da tabela. O nome está vazio para o esquema padrão e contém um valor para outros esquemas. Essa coluna sempre contém um valor.
TABLE_NAME STRING O nome da tabela, visualização ou sinônimo.
TABLE_TYPE STRING O tipo da tabela. Para tabelas, ele tem o valor BASE TABLE. Para visualizações, ele tem o valor VIEW. Para sinônimos, ele tem o valor SYNONYM.
PARENT_TABLE_NAME STRING O nome da tabela pai, se essa tabela estiver entrelaçada, e NULL caso contrário.
ON_DELETE_ACTION STRING Isso é definido como CASCADE ou NO ACTION para tabelas intercaladas e NULL caso contrário. Consulte as instruções TABLE para mais informações.
SPANNER_STATE STRING Uma tabela pode passar por vários estados durante a criação, se houver operações em massa. Por exemplo, quando a tabela é criada com uma chave externa que requer preenchimento dos índices. Os estados possíveis são:
  • ADDING_FOREIGN_KEY: adiciona as chaves estrangeiras da tabela.
  • WAITING_FOR_COMMIT: finalização da alteração de esquema.
  • COMMITTED: a alteração de esquema para criar a tabela foi confirmada. Não é possível gravar na tabela até que a mudança seja confirmada.
INTERLEAVE_TYPE STRING O texto da expressão que indica se há uma relação pai-filho entre esta tabela e a tabela em que ela está intercalada. Os valores possíveis são:
  • IN: a tabela não tem um relacionamento pai-filho. Uma linha nessa tabela pode existir independentemente da existência da linha da tabela mãe.
  • IN PARENT: a tabela tem uma relação pai-filho. Uma linha nessa tabela exige a existência da linha da tabela principal.
  • Uma string vazia indica que esta tabela não tem relações de intercalação.
ROW_DELETION_POLICY_EXPRESSION STRING O texto da expressão que define a política de exclusão de linha da tabela. Por exemplo, OLDER_THAN(CreatedAt, INTERVAL 1 DAY) ou OLDER_THAN(ExpiredDate, INTERVAL 0 DAY).

COLUMNS

Essa tabela filtrada por linha lista as colunas em uma tabela. Os participantes com permissões do IAM no nível do banco de dados e aqueles que receberam acesso à função de sistema spanner_info_reader ou aos membros dela podem ver todas as linhas nessa visualização. Todos os outros principais só podem ver colunas que atendem a um dos seguintes requisitos:

  • Qualquer um dos privilégios de controle de acesso refinado SELECT, INSERT ou UPDATE é concedido diretamente na coluna à função de banco de dados atual, às funções de que a função de banco de dados atual é membro ou a public.
  • Qualquer um dos privilégios de controle de acesso refinado SELECT, INSERT ou UPDATE é concedido na tabela que contém a coluna à função de banco de dados atual, às funções de que a função de banco de dados atual é membro ou a public.
Nome da coluna Tipo Descrição
TABLE_CATALOG STRING Não utilizado. É sempre uma string vazia.
TABLE_SCHEMA STRING O nome do esquema da tabela da coluna. O nome está vazio para o esquema padrão e contém um valor para outros esquemas. Essa coluna sempre contém um valor.
TABLE_NAME STRING O nome da tabela.
COLUMN_NAME STRING O nome da coluna.
ORDINAL_POSITION INT64 A posição ordinal da coluna na tabela, começando com um valor de 1.
COLUMN_DEFAULT STRING

Uma representação de string da expressão SQL para o valor padrão da coluna. NULL se a coluna não tiver um valor padrão.

Observação:antes de março de 2022, o COLUMN_DEFAULT usava o tipo BYTES.

DATA_TYPE STRING Incluído para atender ao padrão SQL. Sempre NULL. Consulte a coluna SPANNER_TYPE
IS_NULLABLE STRING Uma string que indica se a coluna é anulável. De acordo com o padrão SQL, a string é YES ou NO, em vez de um valor booleano.
SPANNER_TYPE STRING O tipo de dados da coluna.
IS_GENERATED STRING Uma string que indica se a coluna foi gerada. A string é ALWAYS para uma coluna gerada ou NEVER para uma coluna não gerada.
GENERATION_EXPRESSION STRING É uma string que representa a expressão SQL de uma coluna gerada. NULL se a coluna não for gerada.
IS_STORED STRING Uma string que indica se a coluna gerada está armazenada. A string é sempre YES para colunas geradas e NULL para colunas não geradas.
IS_HIDDEN STRING Uma string definida como TRUE se a coluna não aparecer em uma consulta SELECT *. Caso contrário, ela será definida como FALSE. Se a coluna estiver oculta, ainda será possível selecioná-la usando o nome dela (por exemplo, SELECT Id, Name, ColHidden FROM TableWithHiddenColumn).
SPANNER_STATE STRING O estado atual da coluna. Uma nova coluna gerada armazenada adicionada a uma tabela existente pode passar por vários estados observáveis pelo usuário antes de ser totalmente utilizável. Os valores possíveis são:
  • WRITE_ONLY: a coluna está sendo preenchida. Nenhuma leitura é permitida.
  • COMMITTED: a coluna pode ser totalmente utilizada.
IS_IDENTITY STRING Uma string definida como YES se a coluna gerada for uma coluna de identidade e NO caso contrário.
IDENTITY_GENERATION STRING Uma string que especifica se a coluna permite apenas valores gerados e não inseridos pelo usuário.
  • BY DEFAULT: o valor padrão. BY DEFAULT especifica que a coluna usa valores gerados se valores inseridos pelo usuário não forem fornecidos.
  • ALWAYS: a coluna permite apenas valores gerados, e não inseridos pelo usuário.
IDENTITY_KIND STRING Sempre BIT_REVERSED_POSITITVE_SEQUENCE. Somente sequências positivas com bits invertidos são compatíveis.
IDENTITY_START_WITH_COUNTER STRING O valor inicial do contador interno antes da transformação. Por exemplo, o valor inicial antes da inversão de bits.
IDENTITY_SKIP_RANGE_MIN STRING O valor mínimo de um intervalo ignorado após a transformação.
IDENTITY_SKIP_RANGE_MAX STRING O valor máximo de um intervalo ignorado após a transformação.

COLUMN_PRIVILEGES

Essa tabela filtrada por linha lista todos os privilégios concedidos no nível da coluna a qualquer papel de banco de dados, incluindo public. Os principais com permissões do IAM no nível do banco de dados e os principais que receberam acesso ao papel de sistema spanner_info_reader ou aos membros desse papel podem ver todas as linhas nessa visualização. Todos os outros principais só podem ver privilégios para colunas que atendem a um dos seguintes requisitos:

  • Qualquer um dos privilégios de controle de acesso refinado SELECT, INSERT ou UPDATE é concedido diretamente na coluna à função de banco de dados atual, às funções de que a função de banco de dados atual é membro ou a public.
  • Qualquer um dos privilégios de controle de acesso refinado SELECT, INSERT ou UPDATE é concedido na tabela que contém a coluna à função de banco de dados atual, às funções de que a função de banco de dados atual é membro ou a public.
Nome da coluna Tipo Descrição
TABLE_CATALOG STRING Não utilizado. É sempre uma string vazia.
TABLE_SCHEMA STRING O nome do esquema da tabela da coluna. O nome está vazio para o esquema padrão e contém um valor para outros esquemas. Essa coluna sempre contém um valor.
TABLE_NAME STRING O nome da tabela que contém a coluna privilegiada.
COLUMN_NAME STRING O nome da coluna privilegiada.
PRIVILEGE_TYPE STRING SELECT, INSERT, UPDATE
GRANTEE STRING O nome da função de banco de dados a que esse privilégio é concedido.

TABLE_PRIVILEGES

Essa tabela filtrada por linha lista todos os privilégios concedidos no nível da tabela aos papéis de banco de dados, incluindo public. Os principais com permissões do IAM no nível do banco de dados e os principais que receberam acesso ao papel do sistema spanner_info_reader ou aos membros desse papel podem ver todas as linhas nessa visualização. Todos os outros principais só podem ver privilégios para tabelas em que um dos privilégios de controle de acesso refinado SELECT, INSERT, UPDATE ou DELETE é concedido à função de banco de dados atual, às funções de que a função de banco de dados atual é membro ou a public.

Nome da coluna Tipo Descrição
TABLE_CATALOG STRING Não utilizado. É sempre uma string vazia.
TABLE_SCHEMA STRING O nome do esquema da tabela. O nome está vazio para o esquema padrão e contém um valor para outros esquemas. Essa coluna sempre contém um valor.
TABLE_NAME STRING O nome da tabela em que os privilégios de controle de acesso refinado são concedidos.
PRIVILEGE_TYPE STRING Um de SELECT, INSERT, UPDATE e DELETE
GRANTEE STRING O nome da função de banco de dados a que esse privilégio é concedido.

TABLE_CONSTRAINTS

Essa tabela contém uma linha para cada restrição definida para as tabelas no banco de dados.

Nome da coluna Tipo Descrição
CONSTRAINT_CATALOG STRING É sempre uma string de tentativa.
CONSTRAINT_SCHEMA STRING O nome de esquema da restrição. É uma string vazia se não tiver nome.
CONSTRAINT_NAME STRING O nome da restrição.
TABLE_CATALOG STRING O nome de catálogo da tabela restrita. É sempre uma string vazia.
TABLE_SCHEMA STRING O nome do esquema da tabela restrita. O nome está vazio para o esquema padrão e contém um valor para outros esquemas. Essa coluna sempre contém um valor.
TABLE_NAME STRING O nome da tabela restrita.
CONSTRAINT_TYPE STRING O tipo da restrição. Os valores possíveis são:
  • PRIMARY KEY
  • FOREIGN KEY
  • PLACEMENT KEY
  • CHECK
  • UNIQUE
IS_DEFERRABLE STRING Sempre NO.
INITIALLY_DEFERRED STRING Sempre NO.
ENFORCED STRING NO se a restrição for uma chave externa informativa (NOT ENFORCED). YES para chaves estrangeiras aplicadas ou qualquer outro tipo de restrição.

CONSTRAINT_TABLE_USAGE

Esta tabela lista tabelas que definem ou são usadas por restrições. Inclui tabelas que definem restrições PRIMARY KEY e UNIQUE. Também inclui as tabelas referenciadas de definições de FOREIGN KEY.

Nome da coluna Tipo Descrição
TABLE_CATALOG STRING O nome do catálogo da tabela restrita. É sempre uma string vazia.
TABLE_SCHEMA STRING O nome do esquema da tabela restrita. O nome está vazio para o esquema padrão e contém um valor para outros esquemas. Essa coluna sempre contém um valor.
TABLE_NAME STRING O nome da tabela restrita.
CONSTRAINT_CATALOG STRING O nome de catálogo da restrição. É sempre uma string vazia.
CONSTRAINT_SCHEMA STRING O nome de esquema da restrição. É uma string vazia se não tiver nome.
CONSTRAINT_NAME STRING O nome da restrição.

REFERENTIAL_CONSTRAINTS

Esta tabela contém uma linha sobre cada restrição FOREIGN KEY.

Nome da coluna Tipo Descrição
CONSTRAINT_CATALOG STRING O nome do catálogo da FOREIGN KEY. É sempre uma string vazia.
CONSTRAINT_SCHEMA STRING O nome de esquema da FOREIGN KEY. É uma string vazia se não tiver nome.
CONSTRAINT_NAME STRING O nome da FOREIGN KEY.
UNIQUE_CONSTRAINT_CATALOG STRING O nome de catálogo da restrição PRIMARY KEY ou UNIQUE que a FOREIGN KEY faz referência. É sempre uma string vazia.
UNIQUE_CONSTRAINT_SCHEMA STRING O nome de esquema da restrição PRIMARY KEY ou UNIQUE que a FOREIGN KEY faz referência. É uma string vazia se não tiver nome.
UNIQUE_CONSTRAINT_NAME STRING O nome da restrição PRIMARY KEY ou UNIQUE que a FOREIGN KEY faz referência.
MATCH_OPTION STRING Sempre SIMPLE.
UPDATE_RULE STRING Sempre NO ACTION.
DELETE_RULE STRING CASCADE ou NO ACTION.
SPANNER_STATE STRING O estado atual da chave externa. O Spanner não começa a aplicar a restrição até que os índices de backup da chave externa sejam criados e preenchidos. Quando os índices estiverem prontos, o Spanner começará a aplicar a restrição para novas transações enquanto valida os dados existentes. Os valores possíveis e os estados que eles representam são:
  • BACKFILLING_INDEXES: os índices estão sendo preenchidos.
  • VALIDATING_DATA: os dados atuais e as novas gravações estão sendo validados.
  • WAITING_FOR_COMMIT: as operações em massa de chave externa foram concluídas com sucesso ou nenhuma foi necessária, mas a chave externa ainda está pendente.
  • COMMITTED: a alteração do esquema foi confirmada.

CHECK_CONSTRAINTS

A tabela information_schema.CHECK_CONSTRAINTS contém uma linha sobre cada restrição CHECK definida pela palavra-chave CHECK ou NOT NULL.

Nome da coluna Tipo Descrição
CONSTRAINT_CATALOG STRING O nome de catálogo da restrição. Essa coluna nunca é nula, mas sempre uma string vazia.
CONSTRAINT_SCHEMA STRING O nome de esquema da restrição. É uma string vazia se não tiver nome.
CONSTRAINT_NAME STRING O nome da restrição. Essa coluna jamais é nula. Se não for especificado explicitamente na definição do esquema, um nome definido pelo sistema será atribuído.
CHECK_CLAUSE STRING As expressões da restrição CHECK. Essa coluna jamais é nula.
SPANNER_STATE STRING O estado atual da restrição CHECK. Essa coluna jamais é nula. Os estados possíveis são os seguintes:
  • VALIDATING: o Spanner está validando os dados atuais.
  • COMMITTED: não há alteração de esquema ativa para essa restrição.

KEY_COLUMN_USAGE

Essa tabela filtrada por linha contém uma linha sobre cada coluna das tabelas de TABLE_CONSTRAINTS que são restritas como chaves por uma restrição PRIMARY KEY, FOREIGN KEY ou UNIQUE. Os principais com permissões do IAM no nível do banco de dados e os principais que receberam acesso ao papel do sistema spanner_info_reader ou aos membros desse papel podem ver todas as linhas nessa visualização. Todos os outros principais só podem ver colunas que atendam aos seguintes critérios:

  • Qualquer um dos privilégios de controle de acesso refinado SELECT, INSERT ou UPDATE é concedido diretamente na coluna à função de banco de dados atual, às funções de que a função de banco de dados atual é membro ou a public.
  • Qualquer um dos privilégios de controle de acesso refinado SELECT, INSERT ou UPDATE é concedido na tabela que contém a coluna à função de banco de dados atual, às funções de que a função de banco de dados atual é membro ou a public.
Nome da coluna Tipo Descrição
CONSTRAINT_CATALOG STRING O nome de catálogo da restrição. É sempre uma string vazia.
CONSTRAINT_SCHEMA STRING O nome de esquema da restrição. Essa coluna jamais é nula. Uma string vazia se não tiver nome.
CONSTRAINT_NAME STRING O nome da restrição.
TABLE_CATALOG STRING O nome de catálogo da coluna restrita. É sempre uma string vazia.
TABLE_SCHEMA STRING O nome do esquema da tabela da coluna restrita. O nome está vazio para o esquema padrão e contém um valor para outros esquemas. Essa coluna sempre contém um valor.
TABLE_NAME STRING O nome da tabela da coluna restrita.
COLUMN_NAME STRING O nome da coluna.
ORDINAL_POSITION INT64 A posição ordinal da coluna na chave da restrição, começando com um valor de 1.
POSITION_IN_UNIQUE_CONSTRAINT INT64 Para FOREIGN KEYs, a posição ordinal da coluna na restrição exclusiva, começando com um valor de 1. Essa coluna é nula para outros tipos de restrição.

CONSTRAINT_COLUMN_USAGE

Essa tabela contém uma linha sobre cada coluna usada por uma restrição. Inclui as colunas PRIMARY KEY e UNIQUE, além das colunas referenciadas das restrições FOREIGN KEY.

Nome da coluna Tipo Descrição
TABLE_CATALOG STRING O nome de catálogo da tabela de colunas. É sempre uma string vazia.
TABLE_SCHEMA STRING O nome do esquema da tabela da coluna. O nome está vazio para o esquema padrão e contém um valor para outros esquemas. Essa coluna sempre contém um valor.
TABLE_NAME STRING O nome da tabela da coluna.
COLUMN_NAME STRING O nome da coluna que é usada pela restrição.
CONSTRAINT_CATALOG STRING O nome de catálogo da restrição. É sempre uma string vazia.
CONSTRAINT_SCHEMA STRING O nome de esquema da restrição. É uma string vazia se não tiver nome.
CONSTRAINT_NAME STRING O nome da restrição.

TABLE_SYNONYMS

Esta tabela lista informações de sinônimos para a tabela.

Nome da coluna Tipo Descrição
TABLE_CATALOG STRING Não utilizado. É sempre uma string vazia.
TABLE_SCHEMA STRING O nome do esquema da tabela. O nome está vazio para o esquema padrão e contém um valor para outros esquemas. Essa coluna sempre contém um valor.
TABLE_NAME STRING O nome da tabela.
SYNONYM_CATALOG STRING O nome do catálogo do sinônimo.
SYNONYM_SCHEMA STRING O nome do esquema do sinônimo.
SYNONYM_TABLE_NAME STRING O nome da tabela do sinônimo.

INDEXES

Essa tabela filtrada por linha lista os índices no banco de dados. Os participantes com permissões do IAM no nível do banco de dados e aqueles que receberam acesso à função de sistema spanner_info_reader ou aos membros dela podem ver todas as linhas nessa visualização. Todos os outros principais só podem ver índices que atendam a um dos seguintes requisitos:

  • Qualquer um dos privilégios de controle de acesso refinado SELECT, INSERT ou UPDATE é concedido no nível da coluna em todas as colunas do índice à função de banco de dados atual, às funções de que a função de banco de dados atual é membro ou a public.
  • Qualquer um dos privilégios de controle de acesso refinado SELECT, INSERT, UPDATE ou DELETE é concedido na tabela que tem o índice à função atual do banco de dados, às funções de que a função atual do banco de dados é membro ou a public.
Nome da coluna Tipo Descrição
TABLE_CATALOG STRING O nome do catálogo. É sempre uma string vazia.
TABLE_SCHEMA STRING O nome do esquema da tabela de índice. O nome está vazio para o esquema padrão e contém um valor para outros esquemas. Essa coluna sempre contém um valor.
TABLE_NAME STRING O nome da tabela.
INDEX_NAME STRING O nome do índice. Tabelas com uma especificação PRIMARY KEY têm uma entrada de pseudoíndice gerada com o nome PRIMARY_KEY, que permite que os campos da chave primária sejam determinados.
INDEX_TYPE STRING O tipo do índice. O tipo é INDEX ou PRIMARY_KEY.
PARENT_TABLE_NAME STRING Os índices secundários podem ser intercalados em uma tabela pai, conforme discutido em Como criar um índice secundário. Essa coluna contém o nome dessa tabela pai ou uma string vazia se o índice não for intercalado.
IS_UNIQUE BOOL Se as chaves do índice precisarem ser exclusivas.
IS_NULL_FILTERED BOOL Se o índice incluir entradas com valores NULL.
INDEX_STATE STRING O estado atual do índice. Os valores possíveis e os estados que eles representam são:
  • PREPARE: criar tabelas vazias para um novo índice.
  • WRITE_ONLY: preencher dados para um novo índice.
  • WRITE_ONLY_CLEANUP: limpar um novo índice.
  • WRITE_ONLY_VALIDATE_UNIQUE: verificar a singularidade dos dados em um novo índice.
  • READ_WRITE: operação de índice normal.
SPANNER_IS_MANAGED BOOL TRUE se o índice for gerenciado pelo Spanner. Caso contrário, FALSE. Os índices secundários de backup de chaves externas são gerenciados pelo Spanner.

INDEX_COLUMNS

Essa tabela filtrada por linha lista as colunas em um índice. Os participantes com permissões do IAM no nível do banco de dados e aqueles que receberam acesso à função de sistema spanner_info_reader ou aos membros dela podem ver todas as linhas nessa visualização. Todos os outros principais só podem ver índices que atendam a um dos seguintes requisitos:

  • Qualquer um dos privilégios de controle de acesso refinado SELECT, INSERT ou UPDATE é concedido no nível da coluna em todas as colunas do índice à função de banco de dados atual, às funções de que a função de banco de dados atual é membro ou a public.
  • Qualquer um dos privilégios de controle de acesso refinado SELECT, INSERT ou UPDATE é concedido na tabela que tem índice para a função de banco de dados atual, para as funções de que a função de banco de dados atual é membro ou para public.
Nome da coluna Tipo Descrição
TABLE_CATALOG STRING O nome do catálogo. É sempre uma string vazia.
TABLE_SCHEMA STRING O nome do esquema da tabela de índice. O nome está vazio para o esquema padrão e contém um valor para outros esquemas. Essa coluna sempre contém um valor.
TABLE_NAME STRING O nome da tabela.
INDEX_NAME STRING O nome do índice.
COLUMN_NAME STRING O nome da coluna.
ORDINAL_POSITION INT64 A posição ordinal da coluna no índice (ou chave primária), começando com um valor de 1. Esse valor é NULL para colunas sem chave (por exemplo, colunas especificadas na cláusula STORING de um índice).
COLUMN_ORDERING STRING O pedido da coluna. O valor é ASC ou DESC para colunas de chave e NULL para colunas não chave (por exemplo, colunas especificadas na cláusula STORING de um índice).
IS_NULLABLE STRING Uma string que indica se a coluna é anulável. De acordo com o padrão SQL, a string é YES ou NO, em vez de um valor booleano.
SPANNER_TYPE STRING O tipo de dados da coluna.

COLUMN_OPTIONS

Essa tabela filtrada por linha lista as opções de coluna em uma tabela. Os principais com permissões do IAM no nível do banco de dados e os principais que receberam acesso à função de sistema spanner_info_reader ou aos membros dessa função podem ver todas as linhas nessa visualização. Todos os outros principais só podem ver opções para colunas que atendem a um dos seguintes requisitos:

  • Qualquer um dos privilégios de controle de acesso refinado SELECT, INSERT ou UPDATE é concedido diretamente na coluna à função de banco de dados atual, às funções de que a função de banco de dados atual é membro ou a public.
  • Qualquer um dos privilégios de controle de acesso refinado SELECT, INSERT ou UPDATE é concedido na tabela que contém a coluna à função de banco de dados atual, às funções de que a função de banco de dados atual é membro ou a public.
Nome da coluna Tipo Descrição
TABLE_CATALOG STRING O nome do catálogo. É sempre uma string vazia.
TABLE_SCHEMA STRING O nome do esquema. O nome está vazio para o esquema padrão e não vazio para outros esquemas (por exemplo, o próprio INFORMATION_SCHEMA). Essa coluna jamais é nula.
TABLE_NAME STRING O nome da tabela.
COLUMN_NAME STRING O nome da coluna.
OPTION_NAME STRING Um identificador SQL que identifica com exclusividade a opção. Esse identificador é a chave da cláusula OPTIONS em DDL.
OPTION_TYPE STRING Um nome do tipo de dados que é o tipo desse valor de opção.
OPTION_VALUE STRING Um literal SQL que descreve o valor dessa opção. O valor dessa coluna precisa ser analisável como parte de uma consulta. A expressão resultante da análise do valor precisa ser convertida em OPTION_TYPE. Essa coluna jamais é nula.

SEQUENCES

Esta tabela lista os metadados de sequências. SEQUENCES é filtrado por linha com base em privilégios de acesso refinado, se um usuário com esses privilégios estiver consultando.

Nome da coluna Tipo Descrição
CATALOG STRING O nome do catálogo que contém a sequência.
SCHEMA STRING O nome do esquema que contém a sequência.
NAME STRING O nome da sequência.
DATA_TYPE STRING O tipo dos valores da sequência. Ele usa o tipo de dados INT64.

SEQUENCE_OPTIONS

Esta tabela contém as opções de configuração para sequências. SEQUENCE_OPTIONS é filtrado por linha com base em privilégios de acesso refinado, se um usuário com privilégios de acesso refinado estiver consultando.

Nome da coluna Tipo Descrição
CATALOG STRING O nome do catálogo que contém a sequência.
SCHEMA STRING O nome do esquema que contém a sequência.
NAME STRING O nome da sequência.
OPTION_NAME STRING O nome da opção de sequência.
OPTION_TYPE STRING Um nome do tipo de dados que é o tipo desse valor de opção.
OPTION_VALUE STRING O valor da opção de sequência. A expressão resultante da análise do valor precisa permitir a conversão em OPTION_TYPE.

SPANNER_STATISTICS

Esta tabela lista os pacotes de estatísticas do otimizador de consultas disponíveis.

Nome da coluna Tipo Descrição
CATALOG_NAME STRING O nome do catálogo. É sempre uma string vazia.
SCHEMA_NAME STRING O nome do esquema. O nome está vazio para o esquema padrão e não vazio para outros esquemas (por exemplo, o próprio INFORMATION_SCHEMA). Essa coluna jamais é nula.
PACKAGE_NAME STRING Nome do pacote de estatísticas.
ALLOW_GC BOOL FALSE se o pacote de estatísticas estiver isento da coleta de lixo. Caso contrário, TRUE.
Esse atributo precisa ser definido como FALSE para fazer referência ao pacote de estatísticas em uma dica ou por meio da API do cliente.

VIEWS

Essa tabela filtrada por linha lista as visualizações no banco de dados. Os participantes com permissões do IAM no nível do banco de dados e aqueles que receberam acesso à função de sistema spanner_info_reader ou aos membros dela podem ver todas as linhas nessa visualização. Todos os outros principais só podem ver as visualizações em que o privilégio de controle de acesso detalhado SELECT é concedido à função de banco de dados atual, às funções de que a função de banco de dados atual é membro ou a public.

Nome da coluna Tipo Descrição
TABLE_CATALOG STRING O nome do catálogo. É sempre uma string vazia.
TABLE_SCHEMA STRING O nome do esquema. É uma string vazia se não tiver nome.
TABLE_NAME STRING Nome da visualização.
VIEW_DEFINITION STRING É o texto SQL da consulta que define a visualização.
SECURITY_TYPE STRING O tipo de segurança da visualização. INVOKER ou DEFINER.

Para mais informações, consulte Sobre as visualizações.

ROLES

Essa tabela filtrada por linha lista os papéis de banco de dados definidos para controle de acesso granular, incluindo papéis do sistema. Os principais com permissões do IAM no nível do banco de dados e aqueles que receberam acesso ao papel do sistema spanner_info_reader ou aos membros desse papel podem ver todos os papéis de banco de dados. Todos os outros principais só podem ver as funções do banco de dados a que receberam acesso diretamente ou por herança.

Nome da coluna Tipo Descrição
ROLE_NAME STRING O nome da função de banco de dados.
IS_SYSTEM BOOL TRUE se a função do banco de dados for uma função do sistema; FALSE caso contrário.

ROLE_GRANTEES

Essa tabela filtrada por linha lista todas as associações de função concedidas explicitamente a todas as funções de banco de dados. Os principais com permissões do IAM no nível do banco de dados e os principais que receberam acesso à função de sistema spanner_info_reader ou aos membros dessa função podem ver todas as linhas nessa visualização. Todos os outros principais só podem ver as associações de função concedidas à função de banco de dados atual ou a uma função de que a função de banco de dados atual é membro.

Como todas as funções de banco de dados são membros da função pública, os resultados omitem registros de associação implícita à função pública.

Nome da coluna Tipo Descrição
ROLE_NAME STRING O nome da função de banco de dados em que essa associação é concedida.
GRANTEE STRING O nome da função de banco de dados a que essa associação é concedida.

CHANGE_STREAMS

Essa tabela filtrada por linha lista todos os fluxo de alterações de um banco de dados e observa quais rastreiam o banco de dados inteiro em vez de tabelas ou colunas específicas. Os principais com permissões do IAM no nível do banco de dados e os principais que receberam acesso à função de sistema spanner_info_reader ou aos membros dessa função podem ver todas as linhas nessa visualização. Todos os outros principais só podem ver streams de alteração em que o privilégio de controle de acesso granular SELECT é concedido à função de banco de dados atual, às funções de que a função de banco de dados atual é membro ou a public.

Nome da coluna Tipo Descrição
CHANGE_STREAM_CATALOG STRING O nome do catálogo do fluxo de alterações. É sempre uma string vazia.
CHANGE_STREAM_SCHEMA STRING O nome do esquema deste fluxo de mudanças. É sempre uma string vazia.
CHANGE_STREAM_NAME STRING O nome do fluxo de alterações.
ALL BOOL TRUE se esse fluxo de alterações rastrear todo o banco de dados. FALSE se esse fluxo de alterações rastrear tabelas ou colunas específicas.

CHANGE_STREAM_TABLES

Essa tabela filtrada por linha contém informações sobre tabelas e os fluxo de alterações que as monitoram. Cada linha descreve uma tabela e um fluxo de alterações. Os principais com permissões do IAM no nível do banco de dados e os principais que receberam acesso à função de sistema spanner_info_reader ou aos membros dessa função podem ver todas as linhas nessa visualização. Todos os outros principais só podem ver linhas de fluxo de alteraçõess em que o privilégio SELECT é concedido à função de banco de dados atual, às funções de que a função de banco de dados atual é membro ou a public.

Os dados em CHANGE_STREAM_TABLES não incluem as relações implícitas entre tabelas e fluxo de alterações que rastreiam todo o banco de dados.

Nome da coluna Tipo Descrição
CHANGE_STREAM_CATALOG STRING O nome do catálogo do fluxo de alterações. É sempre uma string vazia.
CHANGE_STREAM_SCHEMA STRING O nome do esquema do fluxo de alterações. É sempre uma string vazia.
CHANGE_STREAM_NAME STRING O nome do fluxo de alterações a que esta linha se refere.
TABLE_CATALOG STRING O nome do catálogo da tabela. É sempre uma string vazia.
TABLE_SCHEMA STRING O nome do esquema da tabela. É sempre uma string vazia.
TABLE_NAME STRING O nome da tabela a que esta linha se refere.
ALL_COLUMNS BOOL TRUE se o fluxo de alterações desta linha rastrear toda a tabela a que ela se refere. Caso contrário, FALSE.

CHANGE_STREAM_COLUMNS

Essa tabela filtrada por linha contém informações sobre colunas de tabela e os fluxos de mudanças que as monitoram. Cada linha descreve um fluxo de mudanças e uma coluna. Se um fluxo de alterações rastrear uma tabela inteira, as colunas dela não vão aparecer nessa visualização.

Os principais com permissões do IAM no nível do banco de dados e os principais que receberam acesso ao papel do sistema spanner_info_reader ou aos membros desse papel podem ver todas as linhas nessa visualização. Todos os outros principais só podem ver linhas de fluxo de alterações em que o privilégio SELECT é concedido à função de banco de dados atual, às funções de que a função de banco de dados atual é membro ou a public.

Nome da coluna Tipo Descrição
CHANGE_STREAM_CATALOG STRING O nome do catálogo do fluxo de alterações. É sempre uma string vazia.
CHANGE_STREAM_SCHEMA STRING O nome do esquema do fluxo de alterações. É sempre uma string vazia.
CHANGE_STREAM_NAME STRING O nome do fluxo de alterações.
TABLE_CATALOG STRING O nome do catálogo da tabela. É sempre uma string vazia.
TABLE_SCHEMA STRING O nome do esquema da tabela. É sempre uma string vazia.
TABLE_NAME STRING O nome da tabela a que esta linha se refere.
COLUMN_NAME STRING O nome da coluna a que esta linha se refere.

CHANGE_STREAM_OPTIONS

Essa tabela filtrada por linha contém as opções de configuração para fluxo de alterações. Os principais com permissões do IAM no nível do banco de dados e os principais que receberam acesso ao papel do sistema spanner_info_reader ou aos membros desse papel podem ver todas as linhas nessa visualização. Todos os outros principais só podem ver opções de fluxo de alterações em que o privilégio SELECT é concedido à função de banco de dados atual, a funções de que a função de banco de dados atual é membro ou a public.

Nome da coluna Tipo Descrição
CHANGE_STREAM_CATALOG STRING O nome do catálogo do fluxo de alterações. É sempre uma string vazia.
CHANGE_STREAM_SCHEMA STRING O nome do esquema do fluxo de alterações. É sempre uma string vazia.
CHANGE_STREAM_NAME STRING O nome do fluxo de alterações.
OPTION_NAME STRING O nome da opção de fluxo de alterações.
OPTION_TYPE STRING O tipo de dados da opção de fluxo de alterações.
OPTION_VALUE STRING O valor da opção de fluxo de mudanças.

CHANGE_STREAM_PRIVILEGES

Essa tabela filtrada por linha lista todos os privilégios de controle de acesso refinado concedidos em todos os fluxos de mudanças a qualquer função de banco de dados, incluindo public. Os participantes com permissões do IAM no nível do banco de dados e aqueles que receberam acesso à função de sistema spanner_info_reader ou aos membros dela podem ver todas as linhas nessa visualização. Todos os outros principais só podem ver os privilégios concedidos em fluxo de alterações à função atual do banco de dados, às funções de que a função atual do banco de dados é membro ou a public.

Nome da coluna Tipo Descrição
CHANGE_STREAM_CATALOG STRING O nome do catálogo que contém o fluxo de mudanças (uma string vazia).
CHANGE_STREAM_SCHEMA STRING O nome do esquema que contém o fluxo de mudanças (uma string vazia).
CHANGE_STREAM_NAME STRING O nome do fluxo de alterações.
PRIVILEGE_TYPE STRING SELECT (o único privilégio permitido para fluxo de alterações).
GRANTEE STRING O nome da função de banco de dados a que esse privilégio é concedido.

ROUTINES

Essa tabela filtrada por linha lista todas as funções de leitura de fluxo de alterações de um banco de dados. Os principais com permissões do IAM no nível do banco de dados e os principais que receberam acesso ao papel do sistema spanner_info_reader ou aos membros desse papel podem ver todas as linhas nessa visualização. Todos os outros principais só podem ver as funções de leitura do fluxo de alterações em que o privilégio de controle de acesso granular EXECUTE é concedido à função de banco de dados atual, às funções de que a função de banco de dados atual é membro ou a public.

Nome da coluna Tipo Descrição
SPECIFIC_CATALOG STRING O nome do catálogo da rotina. É sempre uma string vazia.
SPECIFIC_SCHEMA STRING O nome do esquema da rotina. É sempre uma string vazia.
SPECIFIC_NAME STRING O nome da rotina. Identifica exclusivamente a rotina, mesmo que o nome dela esteja sobrecarregado.
ROUTINE_CATALOG STRING O nome do catálogo da rotina. É sempre uma string vazia.
ROUTINE_SCHEMA STRING O nome do esquema da rotina. É sempre uma string vazia.
ROUTINE_NAME STRING O nome da rotina. (Pode ser duplicado em caso de sobrecarga.)
ROUTINE_TYPE STRING O tipo de rotina (FUNCTION ou PROCEDURE). Sempre FUNCTION
DATA_TYPE STRING O tipo de dados retornado pela rotina
ROUTINE_BODY STRING O tipo do corpo da rotina (SQL ou EXTERNAL).
ROUTINE_DEFINITION STRING A definição do ROUTINE_BODY.
SECURITY_TYPE STRING O tipo de segurança da rotina. Sempre INVOKER.

ROUTINE_OPTIONS

Essa tabela filtrada por linha contém uma linha para cada opção de cada função de leitura de fluxo de alterações definida.

Os principais com permissões do IAM no nível do banco de dados e os principais que receberam acesso ao papel do sistema spanner_info_reader ou aos membros desse papel podem ver todas as linhas nessa visualização. Todos os outros principais só podem ver opções para funções de leitura de stream de alterações em que o privilégio de controle de acesso granular EXECUTE é concedido à função de banco de dados atual, às funções de que a função de banco de dados atual é membro ou a public.

Nome da coluna Tipo Descrição
SPECIFIC_CATALOG STRING O nome do catálogo da rotina. É sempre uma string vazia.
SPECIFIC_SCHEMA STRING O nome do esquema da rotina. É sempre uma string vazia.
SPECIFIC_NAME STRING O nome da rotina. Identifica de forma exclusiva a rotina em caso de sobrecarga de nome.
OPTION_NAME STRING Um identificador SQL que identifica com exclusividade a opção.
OPTION_TYPE STRING O tipo de dados de OPTION_VALUE.
OPTION_VALUE STRING Um literal SQL que descreve o valor dessa opção. O valor dessa coluna precisa ser analisável como parte de uma consulta.

PARAMETERS

Essa tabela filtrada por linha define os argumentos para cada função de leitura de fluxo de alterações. Cada linha descreve um argumento para uma função de leitura de stream de mudanças.

Os principais com permissões do IAM no nível do banco de dados e os principais que receberam acesso ao papel do sistema spanner_info_reader ou aos membros desse papel podem ver todas as linhas nessa visualização. Todos os outros principais só podem ver parâmetros para funções de leitura de stream de alterações em que o privilégio de controle de acesso granular EXECUTE é concedido à função de banco de dados atual, às funções de que a função de banco de dados atual é membro ou a public.

Nome da coluna Tipo Descrição
SPECIFIC_CATALOG STRING O nome do catálogo da rotina. É sempre uma string vazia.
SPECIFIC_SCHEMA STRING O nome do esquema da rotina. É sempre uma string vazia.
SPECIFIC_NAME STRING O nome da rotina. Identifica de forma exclusiva a rotina em caso de sobrecarga de nome.
ORDINAL_POSITION INT64 A posição ordinal do parâmetro na rotina, começando com um valor de 1.
PARAMETER_NAME STRING O nome do parâmetro.
DATA_TYPE STRING O tipo de dados do parâmetro.
PARAMETER_DEFAULT STRING O valor padrão do parâmetro ou NULL para parâmetros que não têm um valor padrão.

ROUTINE_PRIVILEGES

Essa tabela filtrada por linha lista todos os privilégios de controle de acesso detalhado concedidos em todas as funções de leitura de fluxo de alterações para qualquer papel de banco de dados, incluindo public. Os principais com permissões do IAM no nível do banco de dados e os principais que receberam acesso ao papel do sistema spanner_info_reader ou aos membros desse papel podem ver todas as linhas nessa visualização. Todos os outros principais só podem ver os privilégios concedidos nas funções de leitura de fluxo de mudanças para a função de banco de dados atual, para funções de que a função de banco de dados atual é membro ou para public.

Nome da coluna Tipo Descrição
SPECIFIC_CATALOG STRING O nome do catálogo da rotina. É sempre uma string vazia.
SPECIFIC_SCHEMA STRING O nome do esquema da rotina. É sempre uma string vazia.
SPECIFIC_NAME STRING O nome da rotina. Identifica de forma exclusiva a rotina em caso de sobrecarga de nome.
PRIVILEGE_TYPE STRING Sempre EXECUTE.
GRANTEE STRING O nome da função de banco de dados a que esse privilégio é concedido.

ROLE_TABLE_GRANTS

Essa tabela filtrada por linha lista todos os privilégios de controle de acesso refinado concedidos em todas as tabelas e visualizações a qualquer função de banco de dados, incluindo public. Os participantes com permissões do IAM no nível do banco de dados e aqueles que receberam acesso à função de sistema spanner_info_reader ou aos membros dela podem ver todas as linhas nessa visualização. Todos os outros principais só podem ver os privilégios concedidos em tabelas e visualizações à função de banco de dados atual e às funções de que a função de banco de dados atual é membro, sem incluir public.

Nome da coluna Tipo Descrição
GRANTOR STRING Não utilizado. Sempre NULL.
GRANTEE STRING O nome da função de banco de dados a que esse privilégio é concedido.
TABLE_CATALOG STRING Não utilizado. É sempre uma string vazia.
TABLE_SCHEMA STRING Não utilizado. É sempre uma string vazia.
TABLE_NAME STRING O nome da tabela ou visualização.
PRIVILEGE_TYPE STRING O tipo de privilégio (SELECT, INSERT, UPDATE ou DELETE).
IS_GRANTABLE STRING Não utilizado. Sempre NO.

ROLE_COLUMN_GRANTS

Essa tabela filtrada por linha lista todos os privilégios de controle de acesso refinado concedidos em todas as colunas a qualquer papel de banco de dados, incluindo public. Os principais com permissões do IAM no nível do banco de dados e os principais que receberam acesso à função de sistema spanner_info_reader ou aos membros dessa função podem ver todas as linhas nessa visualização. Todos os outros principais só podem ver os privilégios concedidos nas colunas à função de banco de dados atual e às funções de que ela é membro, sem incluir public.

A visualização inclui os privilégios SELECT, INSERT e UPDATE que a coluna herda da tabela ou visualização que a contém.

Nome da coluna Tipo Descrição
GRANTOR STRING Não utilizado. Sempre NULL.
GRANTEE STRING O nome da função de banco de dados a que esse privilégio é concedido.
TABLE_CATALOG STRING Não utilizado. É sempre uma string vazia.
TABLE_SCHEMA STRING Não utilizado. É sempre uma string vazia.
TABLE_NAME STRING O nome da tabela ou visualização que contém a coluna.
COLUMN_NAME STRING O nome da coluna em que o privilégio é concedido.
PRIVILEGE_TYPE STRING O tipo de privilégio (SELECT, INSERT ou UPDATE).
IS_GRANTABLE STRING Não utilizado. Sempre NO.

ROLE_CHANGE_STREAM_GRANTS

Essa tabela filtrada por linha lista os privilégios SELECT concedidos em todos os fluxos de mudanças a qualquer função de banco de dados, incluindo public. Os participantes com permissões do IAM no nível do banco de dados e aqueles que receberam acesso à função de sistema spanner_info_reader ou aos membros dela podem ver todas as linhas nessa visualização. Todos os outros principais só podem ver os privilégios concedidos em fluxo de alterações à função de banco de dados atual e às funções de que ela é membro, sem incluir public.

Nome da coluna Tipo Descrição
CHANGE_STREAM_CATALOG STRING Não utilizado. É sempre uma string vazia.
CHANGE_STREAM_SCHEMA STRING O nome do esquema que contém o fluxo de alterações.
CHANGE_STREAM_NAME STRING O nome do fluxo de alterações.
PRIVILEGE_TYPE STRING O tipo de privilégio (somente SELECT).
GRANTEE STRING O nome da função de banco de dados a que esse privilégio é concedido.

ROLE_MODEL_GRANTS

Essa tabela filtrada por linha lista todos os privilégios de controle de acesso refinado concedidos em todos os modelos a qualquer função de banco de dados, incluindo public. Os participantes com permissões do IAM no nível do banco de dados e aqueles que receberam acesso à função de sistema spanner_info_reader ou aos membros dela podem ver todas as linhas nessa visualização. Todos os outros principais só podem ver os privilégios concedidos em tabelas e visualizações à função de banco de dados atual e às funções de que a função de banco de dados atual é membro, sem incluir public.

Nome da coluna Tipo Descrição
GRANTOR STRING Não utilizado. Sempre NULL.
GRANTEE STRING O nome da função de banco de dados a que esse privilégio é concedido.
MODEL_CATALOG STRING Não utilizado. É sempre uma string vazia.
MODEL_SCHEMA STRING Não utilizado. É sempre uma string vazia.
MODEL_NAME STRING O nome do modelo.
PRIVILEGE_TYPE STRING O tipo de privilégio (EXECUTE).
IS_GRANTABLE STRING Não utilizado. Sempre NO.

ROLE_ROUTINE_GRANTS

Esta tabela filtrada por linha lista os privilégios EXECUTE concedidos em todas as funções de leitura de fluxo de alterações a qualquer função de banco de dados, incluindo public. Os participantes com permissões do IAM no nível do banco de dados e aqueles que receberam acesso à função de sistema spanner_info_reader ou aos membros dessa função podem ver todas as linhas nessa visualização. Todos os outros principais só podem ver os privilégios concedidos nas funções de leitura do fluxo de alterações para a função de banco de dados atual e para as funções de que ela é membro, sem incluir public.

Nome da coluna Tipo Descrição
GRANTOR STRING Não utilizado. Sempre NULL.
GRANTEE STRING O nome da função a que o privilégio é concedido.
SPECIFIC_CATALOG STRING O nome do catálogo de rotinas.
SPECIFIC_SCHEMA STRING O nome do esquema da rotina.
SPECIFIC_NAME STRING O nome da rotina. Identifica de forma exclusiva a rotina em caso de sobrecarga de nome.
PRIVILEGE_TYPE STRING O tipo de privilégio concedido. Sempre EXECUTE.
IS_GRANTABLE STRING Não utilizado. Sempre NO.

MODELS

Esta tabela lista todos os modelos de um banco de dados.

Nome da coluna Tipo Descrição
MODEL_CATALOG STRING O nome do catálogo. É sempre uma string vazia.
MODEL_SCHEMA STRING O nome do esquema deste modelo. É sempre uma string vazia.
MODEL_NAME STRING O nome do modelo.
IS_REMOTE BOOL TRUE se for um modelo remoto. FALSE se este for um modelo gerenciado.

MODEL_OPTIONS

Esta tabela contém as opções de configuração para modelos.

Nome da coluna Tipo Descrição
MODEL_CATALOG STRING O nome do catálogo. É sempre uma string vazia.
MODEL_SCHEMA STRING O nome do esquema deste modelo. É sempre uma string vazia.
MODEL_NAME STRING O nome do modelo.
OPTION_NAME STRING O nome da opção de modelo.
OPTION_TYPE STRING O tipo de dados da opção de modelo.
OPTION_VALUE STRING O valor da opção do modelo.

MODEL_COLUMNS

Esta tabela lista as colunas em um modelo.

Nome da coluna Tipo Descrição
MODEL_CATALOG STRING O nome do catálogo. É sempre uma string vazia.
MODEL_SCHEMA STRING O nome do esquema deste modelo. É sempre uma string vazia.
MODEL_NAME STRING O nome do modelo.
COLUMN_KIND STRING Tipo de coluna do modelo. Uma destas opções: "INPUT" ou "OUTPUT".
COLUMN_NAME STRING O nome da coluna.
DATA_TYPE STRING O tipo de dados SQL padrão da coluna.
ORDINAL_POSITION INT64 Posição ordinal da coluna, começando com o valor 1, para preservar a ordem das colunas declaradas.
IS_EXPLICIT BOOL TRUE se a coluna foi especificada explicitamente na DDL, FALSE se a coluna foi descoberta no endpoint.

MODEL_COLUMN_OPTIONS

Esta tabela contém as opções de configuração para colunas de modelo.

Nome da coluna Tipo Descrição
MODEL_CATALOG STRING O nome do catálogo. É sempre uma string vazia.
MODEL_SCHEMA STRING O nome do esquema deste modelo. É sempre uma string vazia.
MODEL_NAME STRING O nome do modelo.
COLUMN_KIND STRING Tipo de coluna do modelo. Uma destas opções: "INPUT" ou "OUTPUT".
COLUMN_NAME STRING O nome da coluna.
OPTION_NAME STRING O nome da opção de coluna do modelo.
OPTION_TYPE STRING O tipo de dados da opção de coluna do modelo.
OPTION_VALUE STRING O valor da opção de coluna do modelo.

MODEL_PRIVILEGES

Essa tabela filtrada por linha lista todos os privilégios concedidos no nível do modelo aos papéis de banco de dados, incluindo public. Os principais com permissões do IAM no nível do banco de dados e os principais que receberam acesso ao papel do sistema spanner_info_reader ou aos membros desse papel podem ver todas as linhas nessa visualização. Todos os outros principais só podem ver privilégios para modelos em que o privilégio de controle de acesso refinado EXECUTE é concedido à função de banco de dados atual, às funções de que a função de banco de dados atual é membro ou a public.

Nome da coluna Tipo Descrição
MODEL_CATALOG STRING Não utilizado. É sempre uma string vazia.
MODEL_SCHEMA STRING Não utilizado. É sempre uma string vazia.
MODEL_NAME STRING O nome do modelo em que os privilégios de controle de acesso refinado são concedidos.
PRIVILEGE_TYPE STRING EXECUTE>
GRANTEE STRING O nome da função de banco de dados a que esse privilégio é concedido.

PROPERTY_GRAPHS

Essa tabela filtrada por linha lista os gráficos de propriedades no banco de dados. Os principais com permissões do IAM no nível do banco de dados e os principais que receberam acesso ao papel de sistema spanner_info_reader ou aos membros desse papel podem ver todas as linhas nessa visualização. Todos os outros principais só podem ver gráficos de propriedades se atenderem aos requisitos para acessar todas as tabelas usadas para definir esses gráficos.

Nome da coluna Tipo Descrição
PROPERTY_GRAPH_CATALOG STRING O nome do catálogo. É sempre uma string vazia.
PROPERTY_GRAPH_SCHEMA STRING O nome do esquema. É uma string vazia se não tiver nome.
PROPERTY_GRAPH_NAME STRING O nome do gráfico de propriedades.
PROPERTY_GRAPH_METADATA_JSON JSON A definição do gráfico de propriedades no formato JSON.

A coluna PROPERTY_GRAPH_METADATA_JSON contém um objeto JSON PropertyGraph definido da seguinte maneira:

Nome do objeto JSON Nome do campo Tipo de JSON Descrição
PropertyGraph catalog string O nome do catálogo. É sempre uma string vazia.
schema string O nome do esquema. É uma string vazia se não tiver nome.
name string O nome do gráfico de propriedades.
nodeTables array<object> Uma lista de objetos GraphElementTable para nós.
edgeTables array<object> Uma lista de objetos GraphElementTable para arestas.
labels array<object> Uma lista de objetos GraphElementLabel.
propertyDeclarations array<object> Uma lista de objetos GraphPropertyDeclaration.
GraphElementTable name string O nome da tabela de elementos do gráfico.
kind string NODE ou EDGE.
baseCatalogName string O nome do catálogo que contém a tabela de base.
baseSchemaName string O nome do esquema que contém a tabela base.
baseTableName string O nome da tabela de entrada em que os elementos são criados.
keyColumns array<string> Os nomes das colunas que constituem a chave do elemento.
labelNames array<string> Os nomes dos rótulos anexados a esta tabela de elementos.
propertyDefinitions array<object> Uma lista de objetos GraphPropertyDefinition.
dynamicLabelExpr string O nome da coluna que contém a definição de DYNAMIC LABEL.
dynamicPropertyExpr string O nome da coluna que contém a definição de DYNAMIC PROPERTIES.
sourceNodeTable object Um objeto GraphNodeTableReference. Só existe quando o kind é EDGE.
destinationNodeTable object Um objeto GraphNodeTableReference. Só existe quando o kind é EDGE.
GraphNodeTableReference nodeTableName string O nome da tabela de elementos do gráfico.
edgeTableColumns array<string> O nome das colunas associadas às chaves de origem e de destino das arestas.
nodeTableColumns array<string> O nome das colunas associadas às chaves de origem e destino dos nós.
GraphElementLabel name string Nome do rótulo.
propertyDeclarationNames array<string> Os nomes das propriedades associadas a esse rótulo.
GraphPropertyDeclaration name string O nome da propriedade.
type string O tipo da propriedade.
GraphPropertyDefinition propertyDeclarationName string O nome da propriedade.
valueExpressionSql string A expressão que define a propriedade.

Exemplos

Retorne informações sobre cada tabela no esquema do usuário:

SELECT
  t.table_schema,
  t.table_name,
  t.parent_table_name
FROM
  information_schema.tables AS t
WHERE
  t.table_catalog = ''
  AND
  t.table_schema NOT IN ('information_schema', 'SPANNER_SYS')
  AND t.table_type = 'BASE TABLE'
ORDER BY
  t.table_catalog,
  t.table_schema,
  t.table_name

Retorne o nome de todas as tabelas em INFORMATION_SCHEMA:

SELECT
  t.table_name
FROM
  information_schema.tables AS t
WHERE
  t.table_schema = "SPANNER_SYS"

Retorna informações sobre as colunas na tabela do usuário MyTable no esquema padrão:

SELECT
  t.column_name,
  t.spanner_type,
  t.is_nullable
FROM
  information_schema.columns AS t
WHERE
  t.table_catalog = ''
  AND
  t.table_schema = ''
  AND
  t.table_name = 'MyTable'
ORDER BY
  t.table_catalog,
  t.table_schema,
  t.table_name,
  t.ordinal_position

Retorna informações sobre qual é a região líder padrão do banco de dados. Retorna vazia se o líder padrão não estiver definido:

SELECT
  s.option_name,
  s.option_value
FROM
  information_schema.database_options s
WHERE
  s.option_name = 'default_leader'

Retorne informações sobre cada índice no esquema do usuário:

SELECT
  t.table_schema,
  t.table_name,
  t.index_name,
  t.parent_table_name
FROM
  information_schema.indexes AS t
WHERE
  t.table_catalog = ''
  AND
  t.table_schema NOT IN ('information_schema', 'SPANNER_SYS')
  AND
  t.index_type != 'PRIMARY_KEY'
ORDER BY
  t.table_catalog,
  t.table_schema,
  t.table_name,
  t.index_name

Retorna todas as colunas que usam opções diferentes do padrão:

SELECT
  t.table_schema,
  t.table_name,
  t.column_name,
  t.option_type,
  t.option_value,
  t.option_name
FROM
  information_schema.column_options AS t
WHERE
  t.table_catalog = ''
AND
  t.table_schema NOT IN ('information_schema', 'SPANNER_SYS')

Retorna as opções atuais de banco de dados do otimizador: 

SELECT
  s.option_name,
  s.option_value
FROM
  information_schema.database_options s
WHERE
  s.schema_name=''
  AND s.option_name IN ('optimizer_version',
    'optimizer_statistics_package')

Retorna todos os pacotes de estatísticas disponíveis: 

SELECT
  *
FROM
  information_schema.spanner_statistics;

Retornar todas as sequências: 

SELECT
  *
FROM
  information_schema.sequences;

Retorna todas as opções da sequência chamada "MySequence". 

SELECT
  *
FROM
  information_schema.sequence_options WHERE name="MySequence";

Retorne os nomes de todos os gráficos de propriedades e as definições deles:

SELECT
  property_graph_name,
  property_graph_metadata_json
FROM
  information_schema.property_graphs

Retorne os nomes de todos os gráficos de propriedades com rótulos e propriedades:

SELECT
  property_graph_name,
  property_graph_metadata_json.labels,
  property_graph_metadata_json.propertyDeclarations
FROM
  information_schema.property_graphs

A seguir