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 do INFORMATION_SCHEMA, dependendo do papel do banco de dados. Para mais informações, consulte Sobre o controle de acesso refinado.

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 do Google Cloud )

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

Algumas observações adicionais sobre o uso de INFORMATION_SCHEMA:

Filtragem de linhas em tabelas information_schema

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 em todas as tabelas information_schema. Para outros principais, em algumas tabelas, as linhas são filtradas com base no papel atual do banco de dados. As descrições de tabelas e visualizações nas seções a seguir indicam como a filtragem de linhas é aplicada a cada tabela e visualização.

Tabelas no INFORMATION_SCHEMA

As seções a seguir descrevem as tabelas no 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 definidas por você.

Nome da coluna Tipo Descrição
CATALOG_NAME STRING O nome do catálogo. Essa 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. Esse é um nome para esquemas nomeados ou `` para o esquema padrão.
PROTO_BUNDLE STRING Se o banco de dados tiver instruções de pacote de proto, essa coluna vai fornecer informações sobre o pacote de proto usado no esquema. Essa coluna será NULL se não houver um pacote 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, essa 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 posicionamento.
OPTION_TYPE STRING O tipo de dados da opção de posicionamento. Para as duas opções, é STRING(MAX).
OPTION_VALUE STRING O valor da opção de posicionamento. Para instance_partition, esse é o nome da partição da instância. Para default_leader, é o nome da região líder padrão.

LOCALITY_GROUP_OPTIONS

Para cada grupo de localidade, esta tabela lista o nome e as opções definidas no grupo de localidade 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 localidade. 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 no SSD antes de serem movidos para o HDD.
OPTION_VALUE STRING O valor da opção de grupo de localidade. Para STORAGE, é 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 em 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 ao papel do sistema spanner_info_reader ou aos membros desse papel podem ver todas as linhas nessa visualização. Todos os outros participantes 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 do banco de dados atual, aos papéis em que o papel do banco de dados atual é membro ou a public.
  • Os privilégios SELECT, INSERT ou UPDATE são concedidos em qualquer coluna de tabela ao papel atual do banco de dados, aos papéis em que o papel 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 fica vazio no esquema padrão e contém um valor em 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 esta tabela estiver intercalada e NULL caso contrário.
ON_DELETE_ACTION STRING É definido como CASCADE ou NO ACTION para tabelas intercaladas e NULL caso contrário. Consulte Instruções TABLE para mais informações.
SPANNER_STATE STRING Uma tabela pode passar por vários estados durante a criação, se operações em massa estiverem envolvidas. Por exemplo, quando a tabela é criada com uma chave externa que exige o 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 do esquema para criar a tabela foi confirmada. Não é possível gravar na tabela até que a alteração seja confirmada.
INTERLEAVE_TYPE STRING O texto da expressão que indica se há uma relação pai-filho entre essa tabela e a tabela em que ela está intercalada. Os valores possíveis são:
  • IN: a tabela não tem uma relação pai-filho. Uma linha nessa tabela pode existir independentemente da existência da linha da tabela pai.
  • IN PARENT: a tabela tem uma relação pai-filho. Uma linha nessa tabela requer a existência da linha da tabela pai.
  • Uma string vazia indica que essa 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 linhas 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 de uma tabela. 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 atendem a um dos seguintes requisitos:

  • Qualquer um dos privilégios de controle de acesso refinado SELECT, INSERT ou UPDATE é concedido diretamente na coluna ao papel do banco de dados atual, aos papéis em que o papel do 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 para o papel do banco de dados atual, para papéis em que o papel do banco de dados atual é membro ou para 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 fica vazio no esquema padrão e contém um valor em 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, 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 * e como FALSE, caso contrário. Se a coluna estiver oculta, você ainda poderá selecioná-la usando o nome (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 personalizados inseridos pelo usuário.
  • BY DEFAULT: o valor padrão. BY DEFAULT especifica que a coluna usa valores gerados se os valores inseridos pelo usuário não forem fornecidos.
  • ALWAYS: a coluna permite apenas valores gerados, e não personalizados 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 reversã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.
ON_UPDATE_EXPRESSION STRING Uma STRING com a representação SQL da expressão "ON UPDATE" de uma coluna. Se a coluna não tiver um valor "ON UPDATE", o valor será "NULL".

COLUMN_PRIVILEGES

Esta 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 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 de 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 ao papel atual do banco de dados, aos papéis de que o papel atual do banco de dados é 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 para o papel do banco de dados atual, para papéis em que o papel do banco de dados atual é membro ou para 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 fica vazio no esquema padrão e contém um valor em 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 do papel do banco de dados ao qual esse privilégio é concedido.

TABLE_PRIVILEGES

Esta tabela filtrada por linha lista todos os privilégios concedidos no nível da tabela para papéis do 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 podem ver privilégios apenas para tabelas em que qualquer um dos privilégios de controle de acesso refinado SELECT, INSERT, UPDATE ou DELETE é concedido ao papel do banco de dados atual, aos papéis de que o papel do 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 fica vazio no esquema padrão e contém um valor em 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 do papel do banco de dados ao qual 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 fica vazio no esquema padrão e contém um valor em 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 externas 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 fica vazio no esquema padrão e contém um valor em 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 do esquema da chave externa. É uma string vazia se não tiver nome.
CONSTRAINT_NAME STRING O nome da chave externa.
UNIQUE_CONSTRAINT_CATALOG STRING O nome do catálogo da restrição PRIMARY KEY ou UNIQUE que a FOREIGN KEY referencia. É sempre uma string vazia.
UNIQUE_CONSTRAINT_SCHEMA STRING O nome do esquema da restrição PRIMARY KEY ou UNIQUE que a FOREIGN KEY referencia. É 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 referencia.
MATCH_OPTION STRING Sempre SIMPLE.
UPDATE_RULE STRING Sempre NO ACTION.
DELETE_RULE STRING CASCADE, SET NULL 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 aplicação da chave externa sejam criados e preenchidos. Quando os índices estiverem prontos, o Spanner vai começar a aplicar a restrição para novas transações enquanto valida os dados atuais. 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 atendem aos seguintes critérios:

  • Qualquer um dos privilégios de controle de acesso refinado SELECT, INSERT ou UPDATE é concedido diretamente na coluna ao papel do banco de dados atual, aos papéis em que o papel do 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 para o papel do banco de dados atual, para papéis em que o papel do banco de dados atual é membro ou para 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 fica vazio no esquema padrão e contém um valor em 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 de 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 fica vazio no esquema padrão e contém um valor em 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 as informações de sinônimos da 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 fica vazio no esquema padrão e contém um valor em 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

Esta tabela filtrada por linha lista os índices 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 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 índices que atendem 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 no índice ao papel atual do banco de dados, aos papéis de que o papel atual do banco de dados é 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 para o papel atual do banco de dados, para papéis em que o papel atual do banco de dados é 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 fica vazio no esquema padrão e contém um valor em outros esquemas. Essa coluna sempre contém um valor.
TABLE_NAME STRING O nome da tabela.
INDEX_NAME STRING O nome do índice. As tabelas com uma especificação PRIMARY KEY têm uma entrada de pseudoíndice gerada com o nome PRIMARY_KEY, que permite determinar os campos da chave primária.
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 da tabela pai ou uma string vazia se o índice não estiver 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: verificação da exclusividade 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 de aplicação secundários para chaves externas são gerenciados pelo Spanner.

INDEX_COLUMNS

Esta tabela filtrada por linha lista as colunas em um índice. 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 índices que atendem 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 no índice ao papel atual do banco de dados, aos papéis de que o papel atual do banco de dados é 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 o papel atual do banco de dados, para papéis em que o papel atual do banco de dados é 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 fica vazio no esquema padrão e contém um valor em 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 que não são de 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 que não são de 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

Esta 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 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 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 ao papel atual do banco de dados, aos papéis de que o papel atual do banco de dados é 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 para o papel do banco de dados atual, para papéis em que o papel do 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. 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 das sequências. SEQUENCES é filtrada por linha com base em privilégios de acesso refinado, se um usuário com privilégios de acesso refinado estiver consultando-a.

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 é filtrada por linha com base em privilégios de acesso refinados, se um usuário com privilégios de acesso refinados estiver consultando-a.

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 que resulta da análise do valor precisa permitir a transmissão para 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 referenciar o pacote de estatísticas em uma dica ou pela API do cliente.

VIEWS

Esta tabela filtrada por linha lista as 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 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 visualizações em que o privilégio de controle de acesso refinado SELECT é concedido ao papel do banco de dados atual, aos papéis em que o papel do 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

Esta tabela filtrada por linha lista os papéis de banco de dados definidos para o controle de acesso refinado, incluindo papéis do sistema. 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 todos os papéis do banco de dados. Todos os outros principais podem ver apenas os papéis de banco de dados aos quais receberam acesso diretamente ou por herança.

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

ROLE_GRANTEES

Essa tabela filtrada por linha lista todas as associações de papéis concedidas explicitamente a todos os papéis do 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 associações de papéis concedidas ao papel do banco de dados atual ou a um papel do qual o papel do banco de dados atual é membro.

Como todos os papéis de banco de dados são membros do papel público, os resultados omitem registros de associação implícita no papel público.

Nome da coluna Tipo Descrição
ROLE_NAME STRING O nome do papel do banco de dados em que essa associação é concedida.
GRANTEE STRING O nome do papel do banco de dados ao qual essa associação é concedida.

CHANGE_STREAMS

Essa tabela filtrada por linha lista todos os fluxo de alterações de um banco de dados e indica quais deles rastreiam todo o banco de dados em comparação com 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 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 fluxo de alterações em que o privilégio de controle de acesso refinado SELECT é concedido ao papel do banco de dados atual, aos papéis em que o papel do 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 desse fluxo de alterações. É 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 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 ao papel do banco de dados atual, aos papéis em que o papel do 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 essa 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 essa linha se refere.
ALL_COLUMNS BOOL TRUE se o fluxo de alterações dessa linha rastrear toda a tabela a que essa linha se refere. Caso contrário, FALSE.

CHANGE_STREAM_COLUMNS

Essa tabela filtrada por linha contém informações sobre as colunas da tabela e os fluxos de alterações que as monitoram. Cada linha descreve um fluxo de alterações e uma coluna. Se um fluxo de alterações rastrear uma tabela inteira, as colunas dessa tabela não serão mostradas 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 ao papel do banco de dados atual, aos papéis em que o papel do 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 essa linha se refere.
COLUMN_NAME STRING O nome da coluna a que essa 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 ao papel do banco de dados atual, aos papéis em que o papel do 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 alterações.

CHANGE_STREAM_PRIVILEGES

Esta tabela filtrada por linha lista todos os privilégios de controle de acesso refinado concedidos em todos os fluxos 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 em fluxo de alterações ao papel do banco de dados atual, aos papéis de que o papel do banco de dados atual é 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 alterações (uma string vazia).
CHANGE_STREAM_SCHEMA STRING O nome do esquema que contém o fluxo de alterações (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 do papel do banco de dados ao qual esse privilégio é concedido.

ROUTINES

Essa tabela filtrada por linha lista todas as funções de leitura do 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 refinado EXECUTE é concedido ao papel do banco de dados atual, aos papéis em que o papel do 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 da rotina (FUNCTION ou PROCEDURE). Sempre FUNCTION
DATA_TYPE STRING O tipo de dados que a rotina retorna
ROUTINE_BODY STRING O tipo do corpo da rotina (SQL ou EXTERNAL).
ROUTINE_DEFINITION STRING A definição de 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 podem ver apenas as opções para funções de leitura de fluxo de alterações em que o privilégio de controle de acesso refinado EXECUTE é concedido ao papel atual do banco de dados, aos papéis em que o papel atual do banco de dados é 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 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 do fluxo de alterações. Cada linha descreve um argumento para uma função de leitura de 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 parâmetros para funções de leitura de fluxo de alterações em que o privilégio de controle de acesso refinado EXECUTE é concedido ao papel do banco de dados atual, aos papéis em que o papel do 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 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

Esta tabela filtrada por linha lista todos os privilégios de controle de acesso refinado 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 em funções de leitura de fluxo de alterações ao papel do banco de dados atual, aos papéis de que o papel do 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 em caso de sobrecarga de nome.
PRIVILEGE_TYPE STRING Sempre EXECUTE.
GRANTEE STRING O nome do papel do banco de dados ao qual 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 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 em tabelas e visualizações ao papel de banco de dados atual e aos papéis de que o papel 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 do papel do banco de dados ao qual 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 do 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 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 em colunas ao papel de banco de dados atual e aos papéis de que o papel de banco de dados atual é membro, exceto 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 do papel do banco de dados ao qual 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

Esta tabela filtrada por linha lista os privilégios SELECT concedidos em todos os fluxos de alterações para qualquer papel do 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 em fluxo de alterações ao papel de banco de dados atual e aos papéis de que o papel de banco de dados atual é membro, exceto 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 do papel do banco de dados ao qual esse privilégio é concedido.

ROLE_MODEL_GRANTS

Esta tabela filtrada por linha lista todos os privilégios de controle de acesso refinado concedidos em todos os modelos 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 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 em tabelas e visualizações ao papel de banco de dados atual e aos papéis de que o papel 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 do papel do banco de dados ao qual 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 do privilégio (EXECUTE).
IS_GRANTABLE STRING Não utilizado. Sempre NO.

ROLE_ROUTINE_GRANTS

Essa tabela filtrada por linha lista os privilégios EXECUTE concedidos em todas as funções de leitura do 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 em funções de leitura de fluxo de alterações para o papel de banco de dados atual e para os papéis de que o papel de banco de dados atual é membro, exceto public.

Nome da coluna Tipo Descrição
GRANTOR STRING Não utilizado. Sempre NULL.
GRANTEE STRING O nome do papel ao qual 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 exclusivamente 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 desse modelo. É sempre uma string vazia.
MODEL_NAME STRING O nome do modelo.
IS_REMOTE BOOL TRUE se for um modelo remoto. FALSE se 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 desse 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 de 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 desse modelo. É sempre uma string vazia.
MODEL_NAME STRING O nome do modelo.
COLUMN_KIND STRING Tipo de coluna do modelo. Um destes: "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 desse modelo. É sempre uma string vazia.
MODEL_NAME STRING O nome do modelo.
COLUMN_KIND STRING Tipo de coluna do modelo. Um destes: "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

Esta tabela filtrada por linha lista todos os privilégios concedidos no nível do modelo para papéis do 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 podem ver privilégios apenas para modelos em que o privilégio de controle de acesso refinado do EXECUTE é concedido ao papel do banco de dados atual, aos papéis em que o papel do banco de dados atual é membro ou ao 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 do papel do banco de dados ao qual esse privilégio é concedido.

PROPERTY_GRAPHS

Esta 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 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 gráficos de propriedades se atenderem aos requisitos para ver 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 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 destino das bordas.
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 no 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 de 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 de sequência para a 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 os rótulos e as propriedades deles:

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

A seguir