Esquema de informações para bancos de dados do 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_name
  FROM
    information_schema.tables
  WHERE
    table_schema = ''

Os usuários de controle de acesso detalhado veem resultados filtrados para alguns INFORMATION_SCHEMA de acordo com o papel no banco de dados. Para mais informações, consulte Sobre com controle de acesso refinado.

Uso

As tabelas INFORMATION_SCHEMA estão disponíveis apenas pelas interfaces SQL para 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 oferecem suporte a INFORMATION_SCHEMA.

Algumas observações sobre o uso de 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 aos spanner_info_reader função do sistema (ou aos membros desse papel) pode 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 tabela e visualização nas seções a seguir indicam como a filtragem de linhas é aplicada a cada tabela e visualização.

Tabelas no diretório INFORMATION_SCHEMA

As seções abaixo 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.

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. Este é um nome para esquemas nomeados ou `` para o esquema padrão.
PROTO_BUNDLE STRING Se o banco de dados tiver instruções de pacote proto, essa coluna fornecerá informações sobre o pacote proto usado no esquema. Esta 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 veiculação é padrão.

PLACEMENT_OPTIONS

Para cada canal, esta tabela lista as opções definidas na respectiva 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 canal.
OPTION_TYPE STRING O tipo de dados da opção de posição. Para as duas opções, esse valor é STRING(MAX).
OPTION_VALUE STRING O valor da opção de posição. Para instance_partition, esse é o nome da partição da instância. Para default_leader, é o nome da região líder padrão.

TABLES

Essa tabela filtrada lista as tabelas e visualizações no banco de dados. Diretores com permissões do IAM no nível do banco de dados e principais que foram recebeu acesso ao papel do sistema spanner_info_reader ou aos membros desse papel de usuário podem ver todas as linhas nessa visualização. Todos os outros participantes principais só podem acessar tabelas que atendam a um dos seguintes requisitos:

  • As solicitações SELECT, INSERT, UPDATE ou DELETE controle de acesso refinado os privilégios na tabela são concedidos ao papel do banco de dados atual, aos quais o papel atual do banco de dados é um membro ou para public.
  • Os privilégios SELECT, INSERT ou UPDATE são concedidos em qualquer coluna de tabela para o papel do banco de dados atual, para papéis de 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 Não utilizado. É sempre uma string vazia.
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 ela estiver entrelaçada, ou NULL, caso contrário.
ON_DELETE_ACTION STRING Isso é definido como CASCADE ou NO ACTION para tabelas intercaladas e NULL caso contrário. Consulte TABELA instruções 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 um chave externa que exija o preenchimento de seus í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 tem comprometido. Não é possível gravar na tabela até que a alteração seja comprometido.
INTERLEAVE_TYPE STRING O texto da expressão que indica se há um pai-filho relação entre essa tabela e a tabela na qual 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 a tabela não tem relações intercaladas.
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 de uma tabela. Diretores com as permissões do IAM no nível do banco de dados e os principais que foram recebeu acesso ao papel do sistema spanner_info_reader ou aos membros desse papel de usuário podem ver todas as linhas nessa visualização. Todos os outros participantes podem ver apenas as colunas que atendem a um dos seguintes requisitos:

  • Qualquer uma das opções SELECT, INSERT ou UPDATE privilégios de controle de acesso detalhados são concedidos diretamente na coluna à de banco de dados, aos papéis em que o papel atual do banco de dados é um membro ou para public.
  • Qualquer uma das opções SELECT, INSERT ou UPDATE controle de acesso detalhado são concedidos privilégios na tabela que contém a coluna de banco de dados, para papéis aos quais o papel de banco de dados atual faz parte ou para public.
Nome da coluna Tipo Descrição
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.
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 usou 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.
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.

COLUMN_PRIVILEGES

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

  • Qualquer uma das opções SELECT, INSERT ou UPDATE privilégios de controle de acesso detalhados são concedidos diretamente na coluna à de banco de dados, aos papéis em que o papel atual do banco de dados é um membro ou para public.
  • Qualquer um dos privilégios de controle de acesso detalhado SELECT, INSERT ou UPDATE é concedido na tabela que contém a coluna para a função de banco de dados atual, para funções em que a função de 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 Não utilizado. É sempre uma string vazia.
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 a que esse privilégio é concedido.

TABLE_PRIVILEGES

Esta tabela filtrada por linha lista todos os privilégios concedidos no nível da tabela aos papéis de banco de dados, incluindo public. Principais com IAM no nível do banco de dados permissões e principais que receberam acesso aos recursos Função do sistema spanner_info_reader ou para membros desse papel podem ver todas as linhas em essa visualização. Todos os outros participantes podem conferir privilégios apenas para tabelas em que qualquer dos privilégios de controle de acesso detalhado SELECT, INSERT, UPDATE ou DELETE são concedidos ao papel do banco de dados atual, a 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 Não utilizado. É sempre uma string vazia.
TABLE_NAME STRING O nome da tabela em que os privilégios de controle de acesso refinado são concedidos.
PRIVILEGE_TYPE STRING Uma destas opções: 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. É uma string vazia se não tiver nome.
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 Sempre YES.

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 de esquema da tabela restrita. É uma string vazia se não tiver nome.
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 da FOREIGN KEY de referência. É sempre uma string vazia.
UNIQUE_CONSTRAINT_SCHEMA STRING O nome do esquema da restrição PRIMARY KEY ou UNIQUE da FOREIGN KEY de referência. É uma string vazia se não tiver nome.
UNIQUE_CONSTRAINT_NAME STRING O nome da restrição PRIMARY KEY ou UNIQUE na FOREIGN KEY de 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: dados existentes e 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 linhas contém uma linha sobre cada coluna das tabelas de TABLE_CONSTRAINTS que são limitadas como chaves por uma restrição PRIMARY KEY, FOREIGN KEY ou UNIQUE. Os principais participantes com permissões do IAM no nível do banco de dados e os participantes que receberam acesso ao papel do sistema spanner_info_reader ou a membros desse papel podem conferir todas as linhas nessa visualização. Todos os outros participantes principais só podem acessar colunas que atendem aos seguintes critérios:

  • Qualquer uma das opções SELECT, INSERT ou UPDATE privilégios de controle de acesso detalhados são concedidos diretamente na coluna à de banco de dados, aos papéis em que o papel atual do banco de dados é um membro ou para public.
  • Qualquer uma das opções SELECT, INSERT ou UPDATE controle de acesso detalhado são concedidos privilégios na tabela que contém a coluna de banco de dados, para papéis aos quais o papel de banco de dados atual faz parte 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. Um valor vazio string, 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 de esquema da coluna restrita. Essa coluna jamais é nula. É uma string vazia se não tiver nome.
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 dentro da 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. Isso 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 de esquema da tabela de colunas. Essa coluna jamais é nula. Uma string vazia se não tiver nome.
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 Não utilizado. É sempre uma string vazia.
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 lista os índices no banco de dados. Diretores com as permissões do IAM no nível do banco de dados e os principais que foram recebeu acesso ao papel do sistema spanner_info_reader ou aos membros desse papel de usuário podem ver todas as linhas nessa visualização. Todos os outros principais podem ver apenas índices que atendam a um dos seguintes requisitos:

  • Qualquer uma das opções SELECT, INSERT ou UPDATE privilégios de controle de acesso detalhados são concedidos no nível da coluna em todas colunas no índice para o papel atual do banco de dados, para papéis dos quais o papel atual do banco de dados é um membro ou para public.
  • Qualquer um dos privilégios de controle de acesso detalhado SELECT, INSERT, UPDATE ou DELETE é concedido na tabela que tem o índice para o papel do banco de dados atual, para papéis de 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. É uma string vazia se não tiver nome.
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 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 apoio secundários para chaves externas são gerenciados por no Spanner.

INDEX_COLUMNS

Essa tabela filtrada por linha lista as colunas em um índice. Diretores com as permissões do IAM no nível do banco de dados e os principais que foram recebeu acesso ao papel do sistema spanner_info_reader ou aos membros desse papel de usuário podem ver todas as linhas nessa visualização. Todos os outros principais podem ver apenas índices que atendam a um dos seguintes requisitos:

  • Qualquer uma das opções SELECT, INSERT ou UPDATE privilégios de controle de acesso detalhados são concedidos no nível da coluna em todas colunas no índice para o papel atual do banco de dados, para papéis dos quais o papel atual do banco de dados é um membro ou para 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 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. É uma string vazia se não tiver nome.
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 sem chave colunas (por exemplo, colunas especificadas na classe STORING cláusula 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 lista as opções de coluna em uma tabela. Diretores com permissões do IAM no nível do banco de dados e principais que foram recebeu acesso ao papel do sistema spanner_info_reader ou aos membros desse papel de usuário podem ver todas as linhas nessa visualização. Todos os outros participantes podem ver as opções apenas para colunas que atendem a um dos seguintes requisitos:

  • Qualquer um dos privilégios de controle de acesso detalhado SELECT, INSERT ou UPDATE é concedido diretamente na coluna para o papel do banco de dados atual, para papéis de que o papel do banco de dados atual é membro ou para public.
  • Qualquer um dos privilégios de controle de acesso detalhado SELECT, INSERT ou UPDATE é concedido na tabela que contém a coluna para a função de banco de dados atual, para funções em 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. 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. A linha SEQUENCES é filtrada com base em privilégios de acesso granulares, se um usuário com privilégios de acesso granular fazer consultas nela.

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 específicos é fazer consultas nela.

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, será TRUE.
Esse atributo precisa ser definido como FALSE para fazer referência ao pacote de estatísticas em uma hint ou pela API do cliente.

VIEWS

Essa tabela filtrada por linha lista as visualizações no banco de dados. Participantes com permissões do IAM no nível do banco de dados e participantes que receberam acesso ao papel do sistema spanner_info_reader ou a membros desse papel podem acessar todas as linhas nessa visualização. Todos os outros principais só podem acessar visualizações em que o privilégio de controle de acesso detalhado 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
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 acesso detalhado controle de acesso, incluindo funções do sistema. Diretores com as permissões do IAM no nível do banco de dados e os principais que foram recebeu acesso ao papel do sistema spanner_info_reader ou aos membros desse papel podem consultar todos os papéis de banco de dados. Todos os outros principais podem acessar apenas os papéis de banco de dados a que foram concedidos 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 de banco de dados for um função do sistema Caso contrário, FALSE.

ROLE_GRANTEES

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

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

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 fluxos de alterações de um banco de dados e observa quais deles rastreiam todo o banco de dados em comparação com tabelas ou colunas específicas. Diretores com permissões do IAM no nível do banco de dados e principais que foram recebeu acesso ao papel do sistema spanner_info_reader ou aos membros desse papel de usuário podem ver todas as linhas nessa visualização. Todos os outros principais só podem acessar streams de mudança em que o privilégio de controle de acesso detalhado 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 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 rastreia todo o banco de dados. FALSE, se esse fluxo de alterações rastreia tabelas ou colunas.

CHANGE_STREAM_TABLES

Essa tabela filtrada por linha contém informações sobre as tabelas e os fluxo de alterações que assistem a eles. Cada linha descreve uma tabela e um fluxo de alteração. Diretores com permissões do IAM no nível do banco de dados e principais que foram recebeu acesso ao papel do sistema spanner_info_reader ou aos membros desse papel de usuário podem ver todas as linhas nessa visualização. Todos os outros principais podem ver somente linhas para fluxo de alterações em que o privilégio SELECT é concedido ao usuário de banco de dados, para papéis aos quais o papel de banco de dados atual faz parte ou para 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ção dessa linha rastrear toda a à qual esta 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 a alteração de streaming que assistem a eles. Cada linha descreve um fluxo de mudanças e uma coluna. Se um fluxo de mudanças rastrear uma tabela inteira, as colunas dela não serão mostradas nessa visualização.

Os participantes com permissões do IAM no nível do banco de dados e os participantes 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 acessar linhas de fluxos de mudanças 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.
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 a linha se refere.

CHANGE_STREAM_OPTIONS

Essa tabela filtrada por linha contém as opções de configuração para os fluxo de alterações. Os participantes com permissões do IAM no nível do banco de dados e os participantes 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 opções para fluxo de alterações em que o privilégio SELECT é concedido ao papel atual do banco de dados, até papéis que incluem o papel atual do banco de dados, ou para 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 do fluxo de alterações.

CHANGE_STREAM_PRIVILEGES

Esta tabela filtrada por linha lista todos os privilégios de controle de acesso detalhado concedidos em todas as transmissões de mudanças para qualquer função de banco de dados, incluindo public. Diretores com as permissões do IAM no nível do banco de dados e os principais que foram recebeu acesso ao papel do sistema spanner_info_reader ou aos membros desse papel de usuário podem ver todas as linhas nessa visualização. Todos os outros principais só podem ver os privilégios concedidos em fluxos de mudança para a função de banco de dados atual, para funções das quais a função de banco de dados atual é membro ou para 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 da função do banco de dados a que 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 participantes com permissões do IAM no nível do banco de dados e os participantes 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 funções de leitura do fluxo de alterações em que o privilégio de controle de acesso detalhado EXECUTE está concedido ao papel atual do banco de dados, aos papéis do banco de dados atual é um 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 a rotina de modo exclusivo, mesmo que o nome dele está 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 retornado pela rotina
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 contém uma linha para cada opção de cada função de leitura de fluxo de mudanças definida.

Os participantes com permissões do IAM no nível do banco de dados e os participantes 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 opções para funções de leitura de fluxo de alterações em que o privilégio de controle de acesso detalhado EXECUTE é concedido à função de banco de dados atual, a funções da qual 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 caso de sobrecarga de nomes.
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 mudanças. Cada linha descreve um argumento para uma função de leitura de fluxo de mudanças.

Principais com permissões do IAM no nível do banco de dados e principais que receberam acesso ao papel do sistema spanner_info_reader ou a membros desse papel podem ver todas as linhas nessa visualização. Todos os outros principais podem ver apenas parâmetros para funções de leitura do fluxo de alterações em que o controle de acesso EXECUTE detalhado privilégio é concedido ao papel do banco de dados atual, para os papéis dos quais o papel de banco de dados é um 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 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.

ROUTINE_PRIVILEGES

Esta tabela filtrada por linha lista todos os privilégios de controle de acesso detalhado concedidos em todas as funções de leitura do fluxo de alterações para qualquer função de banco de dados, incluindo public. Os participantes com permissões do IAM no nível do banco de dados e os participantes que receberam acesso ao papel do sistema spanner_info_reader ou a membros desse papel podem conferir todas as linhas nessa visualização. Todos os outros principais podem ver apenas os privilégios concedidos no fluxo de alterações ler funções para o papel de banco de dados atual, para os papéis dos quais o papel de banco de dados é um 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 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

Esta tabela filtrada por linha lista todos os privilégios de controle de acesso detalhados concedidos em todas as tabelas e visualizações para qualquer papel de banco de dados, incluindo public. Diretores com as permissões do IAM no nível do banco de dados e os principais que foram recebeu acesso ao papel do sistema spanner_info_reader ou aos membros desse papel de usuário podem ver todas as linhas nessa visualização. Todos os outros principais só podem acessar os privilégios concedidos em tabelas e visualizações para o papel de banco de dados atual e para papéis de que o papel de banco de dados atual seja membro, exceto 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 de privilégio (SELECT, INSERT, UPDATE ou DELETE).
IS_GRANTABLE STRING Não utilizado. Sempre NO.

ROLE_COLUMN_GRANTS

Esta tabela filtrada por linha lista todos os privilégios de controle de acesso detalhados concedidos em todas as colunas a qualquer papel de banco de dados, incluindo public. Diretores com as permissões do IAM no nível do banco de dados e os principais que foram recebeu acesso ao Função do sistema spanner_info_reader ou para membros desse papel podem ver todas as linhas em essa visualização. Todos os outros principais podem ver apenas os privilégios concedidos nas colunas de o papel atual do banco de dados e os papéis do qual o papel atual do banco de dados é um participante, não incluindo public.

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

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 de SELECT concedidos em todas as mudanças streams para qualquer papel de banco de dados, incluindo public. Diretores com as permissões do IAM no nível do banco de dados e os principais que foram recebeu acesso ao papel do sistema spanner_info_reader ou aos membros desse papel de usuário podem ver todas as linhas nessa visualização. Todos os outros principais podem ver apenas privilégios concedido em fluxo de alterações para o papel de banco de dados atual e para os papéis dos quais papel atual do banco de dados é um membro, não incluindo 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 mudanças.
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 a que esse privilégio é concedido.

ROLE_MODEL_GRANTS

Essa tabela filtrada por linha lista todos os privilégios de controle de acesso detalhado concedidos em todos os modelos a qualquer função de banco de dados, incluindo public. Participantes com permissões do IAM no nível do banco de dados e participantes que receberam acesso ao papel do sistema spanner_info_reader ou a membros desse papel podem acessar todas as linhas nessa visualização. Todos os outros principais só podem acessar os privilégios concedidos em tabelas e visualizações para o papel de banco de dados atual e para 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 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 de privilégio (EXECUTE).
IS_GRANTABLE STRING Não utilizado. Sempre NO.

ROLE_ROUTINE_GRANTS

Esta tabela filtrada por linha lista os privilégios de EXECUTE concedidos em todas as mudanças fazer streaming de funções de leitura para qualquer papel de banco de dados, incluindo public. Diretores com IAM as permissões em nível de banco de dados e os principais que receberam acesso ao Função do sistema spanner_info_reader ou para membros desse papel podem ver todas as linhas em essa visualização. Todos os outros principais podem ver apenas os privilégios concedidos no fluxo de alterações ler funções para o papel do banco de dados atual e para os papéis dos quais o papel de banco de dados é um membro, não incluindo public.

Nome da coluna Tipo Descrição
GRANTOR STRING Não utilizado. Sempre NULL.
GRANTEE STRING O nome do papel 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 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 deste modelo. É sempre uma string vazia.
MODEL_NAME STRING O nome do modelo.
IS_REMOTE BOOL TRUE, se for um modelo remoto. FALSE se isso é 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 de 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 no DDL, ou 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 de modelo. Uma destas opções: "INPUT" ou "OUTPUT".
COLUMN_NAME STRING O nome da coluna.
OPTION_NAME STRING O nome da opção da 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 da coluna do modelo.

MODEL_PRIVILEGES

A 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 participantes com permissões do IAM no nível do banco de dados e os participantes que receberam acesso ao papel do sistema spanner_info_reader ou a membros desse papel podem conferir todas as linhas nessa visualização. Todas as outras principais podem ver apenas privilégios de modelos em que EXECUTE controle de acesso detalhado privilégio é concedido ao papel de banco de dados atual, aos papéis dos quais papel atual do banco de dados é um membro ou para 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 privilégios de controle de acesso refinados são concedidos.
PRIVILEGE_TYPE STRING EXECUTE>
GRANTEE STRING O nome do papel do 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. Participantes com permissões do IAM no nível do banco de dados e participantes que receberam acesso ao papel do sistema spanner_info_reader ou aos membros desse papel podem conferir todas as linhas nessa visualização. Todos os outros principais só podem acessar gráficos de propriedade 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 grafo de propriedade.
nodeTables array<object> Uma lista de objetos GraphElementTable para nós.
edgeTables array<object> Uma lista de objetos GraphElementTable para bordas.
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 a partir da qual 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.
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 arestas.
nodeTableColumns array<string> O nome das colunas associadas à origem e as chaves de 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 de 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_name,
  t.parent_table_name
FROM
  information_schema.tables AS t
WHERE
  t.table_catalog = ''
  AND
  t.table_schema = ''
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:

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_name,
  t.index_name,
  t.parent_table_name
FROM
  information_schema.indexes AS t
WHERE
  t.table_catalog = ''
  AND
  t.table_schema = ''
  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_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 = ''

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;

Retornar todas as opções para a sequência chamada "MySequence"

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

Retorna 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 respectivos 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