Vista VISUALIZAÇÕES

A vista INFORMATION_SCHEMA.VIEWS contém metadados sobre as visualizações.

Autorizações necessárias

Para obter metadados de visualização, precisa das seguintes autorizações de gestão de identidade e de acesso (IAM):

• bigquery.tables.get
• bigquery.tables.list

Cada uma das seguintes funções de IAM predefinidas inclui as autorizações de que precisa para obter metadados de visualização:

• roles/bigquery.admin
• roles/bigquery.dataEditor
• roles/bigquery.metadataViewer
• roles/bigquery.dataViewer

Para mais informações sobre as autorizações do BigQuery, consulte o artigo Controlo de acesso com a IAM.

Esquema

Quando consulta a vista INFORMATION_SCHEMA.VIEWS, os resultados da consulta contêm uma linha para cada vista num conjunto de dados.

A vista INFORMATION_SCHEMA.VIEWS tem o seguinte esquema:

Nome da coluna	Tipo de dados	Valor
table_catalog	STRING	O nome do projeto que contém o conjunto de dados
table_schema	STRING	O nome do conjunto de dados que contém a vista também é conhecido como o conjunto de dados id
table_name	STRING	O nome da vista também é conhecido como a tabela id
view_definition	STRING	A consulta SQL que define a vista
check_option	STRING	O valor devolvido é sempre NULL
use_standard_sql	STRING	YES se a vista tiver sido criada através de uma consulta GoogleSQL; NO se useLegacySql estiver definido como true

Âmbito e sintaxe

As consultas desta vista têm de incluir um conjunto de dados ou um qualificador de região. Para consultas com um qualificador de conjunto de dados, tem de ter autorizações para o conjunto de dados. Para consultas com um qualificador de região, tem de ter autorizações para o projeto. Para mais informações, consulte a secção Sintaxe. A tabela seguinte explica os âmbitos da região e dos recursos para esta vista:

Nome da visualização de propriedade	Âmbito do recurso	Âmbito da região
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.VIEWS	Nível do projeto	REGION
[PROJECT_ID.]DATASET_ID.INFORMATION_SCHEMA.VIEWS	Nível do conjunto de dados	Localização do conjunto de dados

Substitua o seguinte:

• Opcional: PROJECT_ID: o ID do seu projeto do Google Cloud Google Cloud. Se não for especificado, é usado o projeto predefinido.
• REGION: qualquer nome da região do conjunto de dados. Por exemplo, `region-us`.
• DATASET_ID: o ID do seu conjunto de dados. Para mais informações, consulte o artigo Qualificador de conjunto de dados.
  Nota: tem de usar um qualificador de região para consultar as visualizações INFORMATION_SCHEMA. A localização da execução da consulta tem de corresponder à região da vista INFORMATION_SCHEMA.

Por exemplo:

-- Returns metadata for views in a single dataset.
SELECT * FROM myDataset.INFORMATION_SCHEMA.VIEWS;

-- Returns metadata for all views in a region.
SELECT * FROM region-us.INFORMATION_SCHEMA.VIEWS;

Exemplos

Exemplo 1:

O exemplo seguinte obtém todas as colunas da vista, exceto check_option, que está reservada para utilização futura.INFORMATION_SCHEMA.VIEWS Os metadados devolvidos são para todas as vistas em mydataset no seu projeto predefinido: myproject.

Para executar a consulta num projeto que não seja o seu projeto predefinido, adicione o ID do projeto ao conjunto de dados no seguinte formato: `project_id`.dataset.INFORMATION_SCHEMA.view; por exemplo, `myproject`.mydataset.INFORMATION_SCHEMA.VIEWS.

SELECT
  * EXCEPT (check_option)
FROM
  mydataset.INFORMATION_SCHEMA.VIEWS;

Nota: os nomes das INFORMATION_SCHEMAvistas são sensíveis a maiúsculas e minúsculas.

O resultado é semelhante ao seguinte:

  +----------------+---------------+---------------+---------------------------------------------------------------------+------------------+
  | table_catalog  | table_schema  |  table_name   |                        view_definition                              | use_standard_sql |
  +----------------+---------------+---------------+---------------------------------------------------------------------+------------------+
  | myproject      | mydataset     | myview        | SELECT column1, column2 FROM [myproject:mydataset.mytable] LIMIT 10 | NO               |
  +----------------+---------------+---------------+---------------------------------------------------------------------+------------------+
  

Tenha em atenção que os resultados mostram que esta vista foi criada através de uma consulta SQL antiga.

Exemplo 2:

O exemplo seguinte obtém a consulta SQL e a sintaxe de consulta usadas para definir myview em mydataset no seu projeto predefinido: myproject.

Para executar a consulta num projeto que não seja o seu projeto predefinido, adicione o ID do projeto ao conjunto de dados no seguinte formato: `project_id`.dataset.INFORMATION_SCHEMA.view; por exemplo, `myproject`.mydataset.INFORMATION_SCHEMA.VIEWS.

SELECT
  table_name, view_definition, use_standard_sql
FROM
  mydataset.INFORMATION_SCHEMA.VIEWS
WHERE
  table_name = 'myview';

Nota: os nomes das INFORMATION_SCHEMAvistas são sensíveis a maiúsculas e minúsculas.

O resultado é semelhante ao seguinte:

  +---------------+---------------------------------------------------------------+------------------+
  |  table_name   |                        view_definition                        | use_standard_sql |
  +---------------+---------------------------------------------------------------+------------------+
  | myview        | SELECT column1, column2, column3 FROM mydataset.mytable       | YES              |
  +---------------+---------------------------------------------------------------+------------------+
  

Tenha em atenção que os resultados mostram que esta vista foi criada através de uma consulta GoogleSQL.