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 com controle de acesso detalhado veem resultados filtrados para algumas tabelas INFORMATION_SCHEMA
, dependendo da função no banco de dados. Para mais informações, consulte Sobre
o controle de acesso detalhado.
Uso
As tabelas INFORMATION_SCHEMA
estão disponíveis apenas por interfaces SQL. Por
exemplo:
- A API
executeQuery
- O comando
gcloud spanner databases execute-sql
- A página Spanner Studio de um banco de dados no console do Google Cloud
Outros métodos de leitura única não oferecem suporte a INFORMATION_SCHEMA
.
Algumas observações adicionais sobre o uso de INFORMATION_SCHEMA
:
- É possível usar as consultas do
INFORMATION_SCHEMA
em uma transação somente leitura, mas não em uma transação de leitura e gravação. - É possível usar as consultas do
INFORMATION_SCHEMA
com inatividades fortes e limitadas ou com limites de carimbo de data/hora de inatividade exata. - Se você estiver usando um banco de dados de dialeto PostgreSQL, consulte Esquema de informações para bancos de dados de dialeto PostgreSQL.
- Se você for um usuário de controle de acesso detalhado, as tabelas
INFORMATION_SCHEMA
serão filtradas para mostrar apenas os elementos de esquema a que você tem acesso.
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 conferir 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 linha é aplicada em 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.
Nome da coluna | Tipo | Descrição |
---|---|---|
CATALOG_NAME |
STRING |
O nome do catálogo. Esta coluna existe para compatibilidade com tabelas de esquema de informações padrão do SQL. Essa coluna é sempre uma string vazia. |
SCHEMA_NAME |
STRING |
O nome do esquema. É um nome para esquemas nomeados ou " para o esquema padrão. |
PROTO_BUNDLE |
STRING |
Se o banco de dados tiver declarações de protobundle, essa coluna vai fornecer informações sobre o protobundle 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 posição é padrão. |
PLACEMENT_OPTIONS
Para cada posição, a 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, 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. 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 a membros desse
papel podem acessar todas as linhas nessa visualização. Todos os outros participantes principais só podem acessar tabelas
que atendam a um dos seguintes requisitos:
-
Os privilégios de controle de acesso detalhado
SELECT
,INSERT
,UPDATE
ouDELETE
são concedidos na tabela para o papel do banco de dados atual, para papéis em que o papel do banco de dados atual é membro ou parapublic
. - Os privilégios
SELECT
,INSERT
ouUPDATE
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 parapublic
.
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 essa tabela estiver entrelaçada, e
NULL , caso contrário. |
ON_DELETE_ACTION |
STRING |
Isso é definido como CASCADE ou NO ACTION para
tabelas intercaladas e NULL caso contrário. Consulte as
instruções
TABLE para mais informações. |
SPANNER_STATE |
STRING |
Uma tabela pode passar por vários estados durante a criação, se houver operações em massa. Por exemplo, quando a tabela é criada com uma chave estrangeira que requer preenchimento dos índices. Os estados possíveis são:
|
INTERLEAVE_TYPE |
STRING |
O texto da expressão que indica se há uma relação mãe-filha
entre essa tabela e a tabela em que ela está entrelaçada.
Os valores possíveis são:
|
ROW_DELETION_POLICY_EXPRESSION |
STRING |
O texto da expressão que define a
política de exclusão de linha da tabela.
Por exemplo, OLDER_THAN(CreatedAt, INTERVAL 1 DAY) ou
OLDER_THAN(ExpiredDate, INTERVAL 0 DAY) .
|
COLUMNS
Essa tabela filtrada por linha lista as colunas de uma tabela. 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 participantes podem ver apenas as colunas
que atendem a um dos seguintes requisitos:
- Qualquer um dos privilégios de controle de acesso detalhado
SELECT
,INSERT
ouUPDATE
é 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 parapublic
. - Qualquer um dos privilégios de controle de acesso detalhado de
SELECT
,INSERT
ouUPDATE
é 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 parapublic
.
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.
Observação:antes de março de 2022, o |
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:
|
COLUMN_PRIVILEGES
Esta tabela filtrada por linha lista todos os privilégios concedidos no nível da coluna a
qualquer função de banco de dados, incluindo public
. Os participantes com permissões do IAM no nível do banco de dados e 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 podem conferir os privilégios apenas para colunas que atendam
a um dos seguintes requisitos:
- Qualquer um dos privilégios de controle de acesso detalhado
SELECT
,INSERT
ouUPDATE
é 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 parapublic
. - Qualquer um dos privilégios de controle de acesso detalhado
SELECT
,INSERT
ouUPDATE
é 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 parapublic
.
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
Essa tabela filtrada lista todos os privilégios concedidos no nível da tabela a
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 a membros desse papel podem conferir todas as linhas nessa 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 |
Um de SELECT , INSERT , UPDATE
e DELETE |
GRANTEE |
STRING |
O nome do papel do banco de dados a que esse privilégio é concedido. |
TABLE_CONSTRAINTS
Essa tabela contém uma linha para cada restrição definida para as tabelas no banco de dados.
Nome da coluna | Tipo | Descrição |
---|---|---|
CONSTRAINT_CATALOG |
STRING |
É sempre uma string de tentativa. |
CONSTRAINT_SCHEMA |
STRING |
O nome de esquema da restrição. É uma string vazia se não tiver nome. |
CONSTRAINT_NAME |
STRING |
O nome da restrição. |
TABLE_CATALOG |
STRING |
O nome de catálogo da tabela restrita. É sempre uma string vazia. |
TABLE_SCHEMA |
STRING |
O nome do esquema da tabela restrita. É 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:
|
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 do catálogo da restrição PRIMARY KEY ou UNIQUE que a FOREIGN KEY faz referência. É sempre uma string vazia. |
UNIQUE_CONSTRAINT_SCHEMA |
STRING |
O nome do esquema da restrição PRIMARY KEY ou UNIQUE que a FOREIGN KEY faz referência. É uma string vazia se não tiver nome. |
UNIQUE_CONSTRAINT_NAME |
STRING |
O nome da restrição PRIMARY KEY ou UNIQUE que a FOREIGN KEY faz referência. |
MATCH_OPTION |
STRING |
Sempre SIMPLE . |
UPDATE_RULE |
STRING |
Sempre NO ACTION . |
DELETE_RULE |
STRING |
CASCADE ou NO ACTION . |
SPANNER_STATE |
STRING |
O estado atual da chave externa. O Spanner não começa a aplicar
a restrição até que os índices de backup da chave externa sejam criados e
preenchidos. Quando os índices estiverem prontos, o Spanner começará a aplicar a
restrição para novas transações enquanto valida os dados existentes.
Os valores possíveis e os estados que eles representam são:
|
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:
|
KEY_COLUMN_USAGE
Essa tabela filtrada 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 a membros desse papel podem conferir todas as linhas nessa visualização. Todos os outros participantes principais só podem ver colunas que atendem aos seguintes
critérios:
- Qualquer um dos privilégios de controle de acesso detalhado
SELECT
,INSERT
ouUPDATE
é 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 parapublic
. - Qualquer um dos privilégios de controle de acesso detalhado de
SELECT
,INSERT
ouUPDATE
é 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 parapublic
.
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 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 na chave da restrição,
começando com um valor de 1 . |
POSITION_IN_UNIQUE_CONSTRAINT |
INT64 |
Para FOREIGN KEY s, a posição ordinal da coluna na
restrição exclusiva, começando com um valor de 1 . Essa
coluna é nula para outros tipos de restrição. |
CONSTRAINT_COLUMN_USAGE
Essa tabela contém uma linha sobre cada coluna usada por uma restrição. Inclui as colunas
PRIMARY KEY
e UNIQUE
, além das colunas referenciadas das restrições
FOREIGN KEY
.
Nome da coluna | Tipo | Descrição |
---|---|---|
TABLE_CATALOG |
STRING |
O nome de catálogo da tabela de colunas. É sempre uma string vazia. |
TABLE_SCHEMA |
STRING |
O nome 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 informações de sinônimos para a tabela.
Nome da coluna | Tipo | Descrição |
---|---|---|
TABLE_CATALOG |
STRING |
Não utilizado. É sempre uma string vazia. |
TABLE_SCHEMA |
STRING |
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 para o sinônimo. |
INDEXES
Essa tabela filtrada por linha lista os índices 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 administradores podem ver apenas índices
que atendem a um dos seguintes requisitos:
- Qualquer um dos privilégios de controle de acesso detalhado
SELECT
,INSERT
ouUPDATE
é concedido no nível da coluna em todas as colunas no índice para a função de banco de dados atual, para funções das quais a função de banco de dados atual é membro ou parapublic
. - Qualquer um dos privilégios de controle de acesso detalhado
SELECT
,INSERT
,UPDATE
ouDELETE
é 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 parapublic
.
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:
|
SPANNER_IS_MANAGED |
BOOL |
TRUE se o índice for gerenciado pelo Spanner. Caso contrário,
FALSE . Os índices de backup secundários para chaves externas são gerenciados pelo
Spanner. |
INDEX_COLUMNS
Essa tabela filtrada por linha lista as colunas em um índice. 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 administradores podem ver apenas índices
que atendem a um dos seguintes requisitos:
- Qualquer um dos privilégios de controle de acesso detalhado
SELECT
,INSERT
ouUPDATE
é concedido no nível da coluna em todas as colunas no índice para a função de banco de dados atual, para funções das quais a função de banco de dados atual é membro ou parapublic
. - Qualquer um dos privilégios de controle de acesso refinado
SELECT
,INSERT
ouUPDATE
é 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 parapublic
.
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 colunas
sem chave (por exemplo, colunas especificadas na cláusula
STORING de um índice). |
IS_NULLABLE |
STRING |
Uma string que indica se a coluna é anulável. De acordo com o padrão SQL, a string é YES ou NO , em vez de um valor booleano. |
SPANNER_TYPE |
STRING |
O tipo de dados da coluna. |
COLUMN_OPTIONS
Essa tabela filtrada 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 a membros desse
papel podem acessar 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
ouUPDATE
é 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 parapublic
. - Qualquer um dos privilégios de controle de acesso detalhado
SELECT
,INSERT
ouUPDATE
é 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 parapublic
.
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
é filtrado por linha com base em
privilégios de acesso detalhados, se um usuário com privilégios de acesso detalhados estiver
fazendo uma consulta.
Nome da coluna | Tipo | Descrição |
---|---|---|
CATALOG |
STRING |
O nome do catálogo que contém a sequência. |
SCHEMA |
STRING |
O nome do esquema que contém a sequência. |
NAME |
STRING |
O nome da sequência. |
DATA_TYPE |
STRING |
O tipo dos valores da sequência. Ele usa o tipo de dados INT64 . |
SEQUENCE_OPTIONS
Esta tabela contém as opções de configuração para sequências. SEQUENCE_OPTIONS
é filtrado por linha com base em privilégios de acesso detalhados, se um usuário com
privilégios de acesso detalhados estiver fazendo uma consulta.
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 controle de acesso
granular, 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 a membros desse papel podem conferir todos os papéis do banco de dados. Todos os outros principais só podem acessar os papéis do banco de dados
a que foram concedidos acesso diretamente ou por
herança.
Nome da coluna | Tipo | Descrição |
---|---|---|
ROLE_NAME |
STRING |
O nome da função do banco de dados. |
IS_SYSTEM |
BOOL |
TRUE , se a função do banco de dados for uma
função do sistema.
FALSE , caso contrário. |
ROLE_GRANTEES
Essa tabela filtrada por linha lista todas as permissões de função concedidas explicitamente a todos os papéis do 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 a membros desse papel 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 da função pública, os resultados omitem registros de filiação implícita na função pública.
Nome da coluna | Tipo | Descrição |
---|---|---|
ROLE_NAME |
STRING |
O nome da função do banco de dados em que esse acesso é concedido. |
GRANTEE |
STRING |
O nome da função do banco de dados a que 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. 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 a membros desse
papel podem acessar 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 mudanças. É sempre uma string vazia. |
CHANGE_STREAM_NAME |
STRING |
O nome do fluxo de alterações. |
ALL |
BOOL |
TRUE se esse fluxo de alterações rastreia todo o banco de dados.
FALSE se esse fluxo de alterações rastreia tabelas ou colunas específicas. |
CHANGE_STREAM_TABLES
Essa tabela filtrada por linha contém informações sobre tabelas e os fluxos de mudanças
que as monitoram. Cada linha descreve uma tabela e um fluxo de mudanças. Os principais
com permissões do IAM no nível do banco de dados e os principais que receberam
acesso ao papel do sistema spanner_info_reader
ou a membros desse
papel podem acessar todas as linhas nessa visualização. Todos os outros principais podem ver apenas linhas de
fluxos de mudanças em que o privilégio SELECT
é concedido ao papel do banco de dados
atual, a papéis de 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 streams 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 mudança da linha rastreia a totalidade da
tabela a que a 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 as transmissões de mudança que as monitoram. Cada linha descreve um fluxo de mudanças e uma coluna. Se uma transmissão 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 podem ver apenas
linhas de fluxos de mudanças em que o privilégio SELECT
é concedido à
função de banco de dados atual, às funções de que a função de banco de dados atual é membro
ou a public
.
Nome da coluna | Tipo | Descrição |
---|---|---|
CHANGE_STREAM_CATALOG |
STRING |
O nome do catálogo do fluxo de alterações. É sempre uma string vazia. |
CHANGE_STREAM_SCHEMA |
STRING |
O nome do esquema do fluxo de alterações. É sempre uma string vazia. |
CHANGE_STREAM_NAME |
STRING |
O nome do fluxo de alterações. |
TABLE_CATALOG |
STRING |
O nome do catálogo da tabela. É sempre uma string vazia. |
TABLE_SCHEMA |
STRING |
O nome do esquema da tabela. É sempre uma string vazia. |
TABLE_NAME |
STRING |
O nome da tabela a que esta linha se refere. |
COLUMN_NAME |
STRING |
O nome da coluna a que a linha se refere. |
CHANGE_STREAM_OPTIONS
Essa tabela filtrada por linha contém as opções de configuração para fluxos de mudanças.
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 conferir todas as linhas nessa visualização. Todos os outros principais podem ver apenas
as opções de fluxos de mudanças em que o privilégio SELECT
é concedido à
função de banco de dados atual, às funções de que a função de banco de dados atual é membro
ou a public
.
Nome da coluna | Tipo | Descrição |
---|---|---|
CHANGE_STREAM_CATALOG |
STRING |
O nome do catálogo do fluxo de alterações. É sempre uma string vazia. |
CHANGE_STREAM_SCHEMA |
STRING |
O nome do esquema do fluxo de alterações. É sempre uma string vazia. |
CHANGE_STREAM_NAME |
STRING |
O nome do fluxo de alterações. |
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 mudança de stream. |
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
. 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 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 fluxos de alterações).
|
GRANTEE
|
STRING
|
O nome do papel do banco de dados a que esse privilégio é concedido. |
ROUTINES
Esta 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 participantes podem ver apenas
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 em que a função de banco de dados
atual é membro ou a public
.
Nome da coluna | Tipo | Descrição |
---|---|---|
SPECIFIC_CATALOG |
STRING |
O nome do catálogo da rotina. É sempre uma string vazia. |
SPECIFIC_SCHEMA |
STRING |
O nome do esquema da rotina. É sempre uma string vazia. |
SPECIFIC_NAME |
STRING |
O nome da rotina. Identifica exclusivamente a rotina, mesmo que seu nome seja 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 de que a função de banco de dados atual
é membro ou a public
.
Nome da coluna | Tipo | Descrição |
---|---|---|
SPECIFIC_CATALOG
|
STRING
|
O nome do catálogo da rotina. É sempre uma string vazia. |
SPECIFIC_SCHEMA
|
STRING
|
O nome do esquema da rotina. É sempre uma string vazia. |
SPECIFIC_NAME
|
STRING
|
O nome da rotina. Identifica exclusivamente a rotina em caso de sobrecarga de nome. |
OPTION_NAME
|
STRING
|
Um identificador SQL que identifica com exclusividade a opção. |
OPTION_TYPE
|
STRING
|
O tipo de dados de OPTION_VALUE .
|
OPTION_VALUE
|
STRING
|
Um literal SQL que descreve o valor dessa opção. O valor dessa coluna precisa ser analisável como parte de uma consulta. |
PARAMETERS
Essa tabela filtrada por linha define os argumentos para cada função de leitura de fluxo de mudanças. Cada linha descreve um argumento para uma função de leitura de fluxo de mudanças.
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 conferir todas as linhas nessa visualização. Todos os outros principais só podem acessar
os parâmetros 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, às funções em que a função de banco de dados
atual é membro ou a public
.
Nome da coluna | Tipo | Descrição |
---|---|---|
SPECIFIC_CATALOG |
STRING |
O nome do catálogo da rotina. É sempre uma string vazia. |
SPECIFIC_SCHEMA |
STRING |
O nome do esquema da rotina. É sempre uma string vazia. |
SPECIFIC_NAME |
STRING |
O nome da rotina. Identifica exclusivamente a rotina 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 ver todas as linhas
nesta visualização. Todos os outros principais podem conferir apenas os privilégios concedidos nas funções de leitura
do fluxo de mudanças 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 |
---|---|---|
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 a que esse privilégio é concedido. |
ROLE_TABLE_GRANTS
Essa tabela filtrada por linha lista todos os privilégios de controle de acesso detalhado concedidos em todas as tabelas e visualizações para 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 ver 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 a que esse privilégio é concedido. |
TABLE_CATALOG |
STRING |
Não utilizado. É sempre uma string vazia. |
TABLE_SCHEMA |
STRING |
Não utilizado. É sempre uma string vazia. |
TABLE_NAME |
STRING |
O nome da tabela ou visualização. |
PRIVILEGE_TYPE |
STRING |
O tipo de privilégio (SELECT , INSERT ,
UPDATE ou DELETE ). |
IS_GRANTABLE |
STRING |
Não utilizado. Sempre NO . |
ROLE_COLUMN_GRANTS
Esta tabela filtrada por linha lista todos os privilégios de controle de acesso detalhado concedidos em todas as colunas 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 ver todas as linhas nessa visualização. Todos os outros principais só podem ver os privilégios concedidos em colunas para
o papel de banco de dados atual e para 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 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 a que esse privilégio é concedido. |
TABLE_CATALOG |
STRING |
Não utilizado. É sempre uma string vazia. |
TABLE_SCHEMA |
STRING |
Não utilizado. É sempre uma string vazia. |
TABLE_NAME |
STRING |
O nome da tabela ou visualização que contém a coluna. |
COLUMN_NAME |
STRING |
O nome da coluna em que o privilégio é concedido. |
PRIVILEGE_TYPE |
STRING |
O tipo de privilégio (SELECT ,
INSERT ou UPDATE ). |
IS_GRANTABLE |
STRING |
Não utilizado. Sempre NO . |
ROLE_CHANGE_STREAM_GRANTS
Esta tabela filtrada por linha lista os privilégios SELECT
concedidos em todos os fluxos
de mudanças para qualquer função do 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 podem ver apenas os privilégios
concedidos nos fluxos de alterações para a função de banco de dados atual e para as funções das quais a
função 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 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 ver 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 a que esse privilégio é concedido. |
MODEL_CATALOG |
STRING |
Não utilizado. É sempre uma string vazia. |
MODEL_SCHEMA |
STRING |
Não utilizado. É sempre uma string vazia. |
MODEL_NAME |
STRING |
O nome do modelo. |
PRIVILEGE_TYPE |
STRING |
O tipo de privilégio (EXECUTE ). |
IS_GRANTABLE |
STRING |
Não utilizado. Sempre NO . |
ROLE_ROUTINE_GRANTS
Esta tabela filtrada por linha lista os privilégios EXECUTE
concedidos em todas as funções de leitura
do fluxo de alterações para qualquer função de banco de dados, incluindo public
. Os participantes com permissões no nível do banco de dados do IAM e os 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 os privilégios concedidos nas funções de leitura
do fluxo de alterações para a função de banco de dados atual e para as funções das quais a função 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 a que o privilégio é concedido. |
SPECIFIC_CATALOG
|
STRING
|
O nome do catálogo de rotinas. |
SPECIFIC_SCHEMA
|
STRING
|
O nome do esquema de 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 este
for um modelo gerenciado. |
MODEL_OPTIONS
Esta tabela contém as opções de configuração para modelos.
Nome da coluna | Tipo | Descrição |
---|---|---|
MODEL_CATALOG |
STRING |
O nome do catálogo. É sempre uma string vazia. |
MODEL_SCHEMA |
STRING |
O nome do esquema 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 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 desse modelo. É sempre uma string vazia. |
MODEL_NAME |
STRING |
O nome do modelo. |
COLUMN_KIND |
STRING |
Tipo de coluna do modelo. Um de: "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 desse modelo. É sempre uma string vazia. |
MODEL_NAME |
STRING |
O nome do modelo. |
COLUMN_KIND |
STRING |
Tipo de coluna do modelo. Um de: "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 da coluna do modelo. |
MODEL_PRIVILEGES
Essa tabela filtrada por linha lista todos os privilégios concedidos no nível do modelo a
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 a membros desse papel podem conferir todas as linhas nessa visualização. Todos os outros principais podem conferir privilégios apenas para modelos em que o
privilégio de controle de acesso detalhado
EXECUTE
é concedido à função de banco de dados atual, a funções em que a
função de banco de dados atual é membro ou a public
.
Nome da coluna | Tipo | Descrição |
---|---|---|
MODEL_CATALOG |
STRING |
Não utilizado. É sempre uma string vazia. |
MODEL_SCHEMA |
STRING |
Não utilizado. É sempre uma string vazia. |
MODEL_NAME |
STRING |
O nome do modelo em que os privilégios de controle de acesso granular 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. Todas as outras partes 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 grafo de propriedade. |
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 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 . |
|
sourceNodeTable |
object |
Um objeto GraphNodeTableReference . Só existe quando o
kind é EDGE . |
|
destinationNodeTable |
object |
Um objeto GraphNodeTableReference . Só existe quando o
kind é EDGE . |
|
GraphNodeTableReference |
nodeTableName |
string |
O nome da tabela de elementos do gráfico. |
edgeTableColumns |
array<string> |
O nome das colunas associadas às chaves de origem e de destino das arestas. | |
nodeTableColumns |
array<string> |
O nome das colunas associadas às chaves de origem e 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 da propriedade. | |
GraphPropertyDefinition |
propertyDeclarationName |
string |
O nome da propriedade. |
valueExpressionSql |
string |
A expressão que define a propriedade. |
Examples
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 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 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;
Retorna todas as sequências:
SELECT
*
FROM
information_schema.sequences;
Retorna todas as opções de sequência para a sequência "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:
SELECT
property_graph_name,
property_graph_metadata_json.labels,
property_graph_metadata_json.propertyDeclarations
FROM
information_schema.property_graphs
A seguir
- Saiba mais sobre as ferramentas de introspecção disponíveis para ajudar você a investigar problemas de banco de dados.