Neste documento, descrevemos como receber informações ou metadados sobre visualizações no BigQuery.
Para receber metadados de visualizações:
- Como usar o Console do Cloud
- Use o comando
bq show
da ferramenta de linha de comandobq
. - utilize o método da API
tables.get
; - Como usar bibliotecas de cliente
- consulte as visualizações
INFORMATION_SCHEMA
(Beta);
Permissões necessárias
Para receber informações sobre visualizações, você precisa ter, no mínimo, as permissões bigquery.tables.get
. Os seguintes papéis predefinidos do IAM incluem as permissões bigquery.tables.get
:
bigquery.metadataViewer
bigquery.dataViewer
bigquery.dataOwner
bigquery.dataEditor
bigquery.admin
Além disso, quando um usuário tem permissões bigquery.datasets.create
e cria um conjunto de dados, ele recebe o acesso bigquery.dataOwner
ao conjunto.
O acesso bigquery.dataOwner
permite que o usuário receba informações sobre as visualizações no conjunto de dados.
Para mais informações sobre papéis e permissões do IAM no BigQuery, consulte Controle de acesso.
Como receber informações sobre visualizações
O processo para receber informações sobre visualizações é idêntico ao usado para tabelas.
Para receber informações sobre visualizações:
Console
Expanda seu conjunto de dados.
Clique no nome da visualização.
Clique em Detalhes. A guia Detalhes exibe a descrição e as informações da visualização e a consulta SQL que define a visualização.
bq
Emita o comando bq show
. A sinalização --format
pode ser usada para controlar a saída. Se você estiver recebendo informações sobre uma visualização em um projeto diferente do projeto padrão, adicione o ID do projeto ao conjunto de dados no seguinte formato: [PROJECT_ID]:[DATASET]
.
bq show \ --format=prettyjson \ project_id:dataset.view
Em que:
- project_id é o ID do projeto;
- dataset é o nome do conjunto de dados.
- view é o nome da visualização.
Exemplos:
Digite o seguinte comando para exibir informações sobre myview
no conjunto de dados mydataset
em seu projeto padrão.
bq show --format=prettyjson mydataset.myview
Digite o seguinte comando para exibir informações sobre myview
no conjunto de dados mydataset
em myotherproject
.
bq show --format=prettyjson myotherproject:mydataset.myview
API
Chame o método tables.get
e forneça os parâmetros relevantes.
Go
Antes de testar essa amostra, siga as instruções de configuração para Go no Guia de início rápido do BigQuery: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API BigQuery em Go.
Java
Antes de testar essa amostra, siga as instruções de configuração para Java no Guia de início rápido do BigQuery: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API BigQuery em Java.
Node.js
Antes de testar essa amostra, siga as instruções de configuração para Node.js no Guia de início rápido do BigQuery: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API BigQuery Node.js.
Python
Antes de testar essa amostra, siga as instruções de configuração para Python no Guia de início rápido do BigQuery: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API BigQuery em Python.
INFORMATION_SCHEMA
(Beta)
INFORMATION_SCHEMA
é uma série de visualizações que fornecem acesso a metadados
sobre conjuntos de dados, rotinas, tabelas, visualizações, jobs, reservas e dados de streaming.
Visualização VIEWS
Quando você consulta a visualização INFORMATION_SCHEMA.VIEWS
, os resultados da consulta contêm uma linha para cada visualização em um conjunto de dados.
A visualização INFORMATION_SCHEMA.VIEWS
tem o seguinte esquema:
Nome da coluna | Tipo de dados | Valor |
---|---|---|
TABLE_CATALOG |
STRING |
Nome do projeto que contém o conjunto de dados |
TABLE_SCHEMA |
STRING |
O nome do conjunto de dados que contém a visualização da propriedade também conhecido como o conjunto de dados id |
TABLE_NAME |
STRING |
O nome da visualização da propriedade também conhecido como tabela id |
VIEW_DEFINITION |
STRING |
Consulta SQL que define a visualização |
CHECK_OPTION |
STRING |
O valor retornado é sempre NULL |
USE_STANDARD_SQL |
STRING |
YES se a visualização foi criada usando uma consulta SQL padrão; NO se useLegacySql estiver definido como true |
Exemplos
Exemplo 1:
O exemplo a seguir recupera todas as colunas da visualização INFORMATION_SCHEMA.VIEWS
, exceto check_option
, que é reservada para uso futuro. Os metadados retornados são para todas as visualizações em mydataset
em seu projeto padrão – myproject
.
Para executar a consulta em um projeto diferente do projeto padrão, adicione o código do projeto ao conjunto de dados no seguinte formato: `project_id`.dataset.INFORMATION_SCHEMA.view
. Veja um exemplo: `myproject`.mydataset.INFORMATION_SCHEMA.VIEWS
.
Para executar a consulta, faça o seguinte:
Console
Abra a página do BigQuery no Console do Cloud.
Insira a consulta SQL padrão a seguir na caixa Editor de consultas.
INFORMATION_SCHEMA
requer sintaxe SQL padrão. O SQL padrão é a sintaxe padrão do Console do Cloud.SELECT * EXCEPT(check_option) FROM mydataset.INFORMATION_SCHEMA.VIEWS
Clique em Executar.
bq
Use o comando query
e especifique a sintaxe SQL padrão usando a sinalização --nouse_legacy_sql
ou --use_legacy_sql=false
. A sintaxe SQL padrão é obrigatória para consultas INFORMATION_SCHEMA
.
Para executar a consulta, insira:
bq query --nouse_legacy_sql \ 'SELECT * EXCEPT(check_option) FROM mydataset.INFORMATION_SCHEMA.VIEWS'
Os resultados terão a aparência abaixo:
+----------------+---------------+---------------+---------------------------------------------------------------------+------------------+ | table_catalog | table_schema | table_name | view_definition | use_standard_sql | +----------------+---------------+---------------+---------------------------------------------------------------------+------------------+ | myproject | mydataset | myview | SELECT column1, column2 FROM [myproject:mydataset.mytable] LIMIT 10 | NO | +----------------+---------------+---------------+---------------------------------------------------------------------+------------------+
Observando os resultados, vemos que essa visualização foi criada com uma consulta SQL legada.
Exemplo 2:
O exemplo a seguir recupera a consulta SQL e a sintaxe de consulta usadas para definir myview
em mydataset
em seu projeto padrão – myproject
.
Para executar a consulta em um projeto diferente do projeto padrão, adicione o código do projeto ao conjunto de dados no seguinte formato: `project_id`.dataset.INFORMATION_SCHEMA.view
. Veja um exemplo: `myproject`.mydataset.INFORMATION_SCHEMA.VIEWS
.
Para executar a consulta, faça o seguinte:
Console
Abra a página do BigQuery no Console do Cloud.
Insira a consulta SQL padrão a seguir na caixa Editor de consultas.
INFORMATION_SCHEMA
requer sintaxe SQL padrão. O SQL padrão é a sintaxe padrão do Console do Cloud.SELECT table_name, view_definition, use_standard_sql FROM mydataset.INFORMATION_SCHEMA.VIEWS WHERE table_name="myview"
Clique em Executar.
bq
Use o comando query
e especifique a sintaxe SQL padrão usando a sinalização --nouse_legacy_sql
ou --use_legacy_sql=false
. A sintaxe SQL padrão é obrigatória para consultas INFORMATION_SCHEMA
.
Para executar a consulta, insira:
bq query --nouse_legacy_sql \ 'SELECT table_name, view_definition, use_standard_sql FROM mydataset.INFORMATION_SCHEMA.VIEWS WHERE table_name="myview"'
Os resultados terão a aparência abaixo:
+---------------+---------------------------------------------------------------+------------------+
| table_name | view_definition | use_standard_sql |
+---------------+---------------------------------------------------------------+------------------+
| myview | SELECT column1, column2, column3 FROM mydataset.mytable
| YES |
+---------------+---------------------------------------------------------------+------------------+
Observando os resultados, vemos que essa visualização foi criada com uma consulta SQL padrão.
Próximas etapas
- Para informações sobre como criar visualizações, consulte Como criar visualizações.
- Para informações sobre a criação de uma visualização autorizada, consulte Como criar visualizações autorizadas.
- Para informações sobre a listagem de visualizações, consulte Como listar visualizações.
- Para informações sobre a atualização de visualizações, consulte Como atualizar visualizações.
- Consulte Como gerenciar visualizações para mais informações.
- Acesse Introdução ao BigQuery
INFORMATION_SCHEMA
para uma visão geral deINFORMATION_SCHEMA
.