Visualização TABLE_CONSTRAINTS
A visualização TABLE_CONSTRAINTS
contém as relações de chave primária e externa
em um conjunto de dados do BigQuery.
Permissões necessárias
Você precisa das seguintes permissões do Identity and Access Management (IAM):
bigquery.tables.get
para visualizar as definições de chave primária e externa.bigquery.tables.list
para visualizar esquemas de informações da tabela.
Cada um dos papéis predefinidos a seguir tem as permissões necessárias para executar os fluxos de trabalho detalhados neste documento:
roles/bigquery.dataEditor
roles/bigquery.dataOwner
roles/bigquery.admin
Para mais informações sobre os papéis e as permissões do IAM no BigQuery, consulte Papéis e permissões predefinidos.
Esquema
A visualização INFORMATION_SCHEMA.TABLE_CONSTRAINTS
tem o seguinte esquema:
Nome da coluna | Tipo | Significado |
---|---|---|
|
|
O nome do projeto de restrição. |
|
|
O nome do conjunto de dados de restrição. |
|
|
O nome da restrição. |
|
|
O nome do projeto na tabela restrita. |
|
|
O nome do conjunto de dados da tabela restrita. |
|
|
O nome da tabela restrita. |
|
|
PRIMARY KEY ou
FOREIGN KEY . |
|
|
YES ou NO , dependendo de uma restrição ser
adiada. Somente NO é aceito. |
|
|
Somente NO é aceito. |
|
|
YES ou NO , dependendo da aplicação da
restrição. Somente NO é aceito. |
Escopo e sintaxe
As consultas nesta visualização precisam ter um qualificador de conjunto de dados. Para consultas com um qualificador de conjunto de dados, é preciso ter permissões para o conjunto de dados. Para mais informações, consulte Sintaxe. A tabela a seguir explica os escopos de região e recurso dessa visualização:
Nome da visualização | Escopo do recurso | Escopo da região |
---|---|---|
[PROJECT_ID.]DATASET.INFORMATION_SCHEMA.TABLE_CONSTRAINTS; |
Nível do conjunto de dados | Local do conjunto de dados |
Opcional: PROJECT_ID
: o ID do seu
projeto do Google Cloud. Se não for especificado, o projeto padrão será usado.
Exemplos
A consulta a seguir mostra as restrições de uma única tabela em um conjunto de dados:
SELECT * FROM PROJECT_ID.DATASET.INFORMATION_SCHEMA.TABLE_CONSTRAINTS WHERE table_name = TABLE;
Substitua:
PROJECT_ID
: opcional. O nome do projeto na nuvem. Se não for especificado, esse comando usará o projeto padrão.DATASET
: o nome do conjunto de dados.TABLE
: o nome da tabela.
Por outro lado, a consulta a seguir mostra as restrições de todas as tabelas em um único conjunto de dados.
SELECT * FROM PROJECT_ID.DATASET.INFORMATION_SCHEMA.TABLE_CONSTRAINTS;
Com as restrições atuais, os resultados da consulta serão semelhantes aos seguintes:
+-----+---------------------+-------------------+-----------------------+---------------------+--------------+------------+-----------------+---------------+--------------------+----------+ | Row | constraint_catalog | constraint_schema | constraint_name | table_catalog | table_schema | table_name | constraint_type | is_deferrable | initially_deferred | enforced | +-----+---------------------+-------------------+-----------------------+---------------------+--------------+------------+-----------------+---------------+--------------------+----------+ | 1 | myConstraintCatalog | myDataset | orders.pk$ | myConstraintCatalog | myDataset | orders | PRIMARY KEY | NO | NO | NO | | 2 | myConstraintCatalog | myDataset | orders.order_customer | myConstraintCatalog | myDataset | orders | FOREIGN KEY | NO | NO | NO | +-----+---------------------+-------------------+-----------------------+---------------------+--------------+------------+-----------------+---------------+--------------------+----------+
Se a tabela ou o conjunto de dados não tiver restrições, os resultados da consulta serão parecidos com estes:
+-----------------------------+ | There is no data to display | +-----------------------------+