Como receber informações sobre visualizações

Neste documento, descrevemos como receber informações ou metadados sobre visualizações no BigQuery.

Para receber metadados de visualizações:

use o Console do GCP ou a IU clássica da Web do BigQuery;
use o comando bq show da CLI;
chame o método de API tables.get;
use bibliotecas de cliente;
consulte as visualizações INFORMATION_SCHEMA (beta).

Permissões necessárias

Para receber informações sobre tabelas, é necessário ter, no mínimo, permissões bigquery.tables.get. Os papéis predefinidos do Cloud IAM a seguir incluem as permissões bigquery.tables.get:

bigquery.metadataViewer
bigquery.dataViewer
bigquery.dataOwner
bigquery.dataEditor
bigquery.admin

Além disso, quando um usuário com permissões bigquery.datasets.create cria um conjunto de dados, recebe o acesso bigquery.dataOwner a ele. Com o acesso bigquery.dataOwner, o usuário consegue receber informações sobre visualizações em um conjunto de dados.

Para mais informações sobre papéis e permissões do Cloud 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 da visualização, informações de visualização e a consulta SQL que define a visualização.

IU clássica

Expanda seu conjunto de dados.
Clique no nome da visualização.
Clique em Detalhes. A página Exibir detalhes exibe a descrição da visualização, as informações da visualização e a consulta SQL que define a visualização.

CLI

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 padrão, adicione o código 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 no 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 este exemplo, siga as instruções de configuração do 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 Go.

Ver no GitHub Feedback

// To run this sample, you will need to create (or reuse) a context and
// an instance of the bigquery client.  For example:
// import "cloud.google.com/go/bigquery"
// ctx := context.Background()
// client, err := bigquery.NewClient(ctx, "your-project-id")
view := client.Dataset(datasetID).Table(viewID)
meta, err := view.Metadata(ctx)
if err != nil {
	return err
}
fmt.Printf("View %s, query: %s\n", view.FullyQualifiedName(), meta.ViewQuery)

Python

Antes de testar esta amostra, siga as instruções de configuração do 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 Python.

Ver no GitHub Feedback

# from google.cloud import bigquery
# client = bigquery.Client()
# shared_dataset_id = 'my_shared_dataset'

view_ref = client.dataset(shared_dataset_id).table("my_shared_view")
view = client.get_table(view_ref)  # API Request

# Display view properties
print("View at {}".format(view.full_table_id))
print("View Query:\n{}".format(view.view_query))

`INFORMATION_SCHEMA` (beta)

INFORMATION_SCHEMA é uma série de visualizações que fornecem acesso a metadados sobre conjuntos de dados, tabelas e visualizações.

Visualização `VIEWS`

Quando consultamos a visualização INFORMATION_SCHEMA.VIEWS, os resultados contêm uma linha para cada visualização no conjunto de dados.

As consultas na visualização INFORMATION_SCHEMA.VIEWS precisam ter um qualificador de conjunto de dados. O usuário que envia a consulta precisa ter acesso ao conjunto de dados que contém as visualizações.

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`	Nome do conjunto de dados que contém a visualização, também conhecido como `id` do conjunto de dados.
`TABLE_NAME`	`STRING`	Nome da visualização, também conhecido como `id` da tabela.
`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`.

Para mais informações sobre propriedades de tabela e visualização, consulte a página do recurso de tabela na documentação da API REST.

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 correspondem a todas as visualizações em mydataset no projeto padrão myproject.

Para executar a consulta em um projeto diferente do padrão, adicione o ID do projeto ao conjunto de dados no formato a seguir: `project_id`.dataset.INFORMATION_SCHEMA.view. Por exemplo, `myproject`.mydataset.INFORMATION_SCHEMA.VIEWS.

Para executar a consulta, faça o seguinte:

Console

Abra a IU da Web do BigQuery no Console do GCP.

Acessar o Console do GCP
Insira a consulta SQL padrão a seguir na caixa Editor de consultas. INFORMATION_SCHEMA requer sintaxe SQL padrão. SQL padrão é a sintaxe padrão no Console do GCP.
```
SELECT
 * EXCEPT(check_option)
FROM
 mydataset.INFORMATION_SCHEMA.VIEWS
```
Observação: os nomes de visualização INFORMATION_SCHEMA diferenciam maiúsculas e minúsculas.
Clique em Executar.

CLI

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 no projeto padrão (myproject).

Para executar a consulta, faça o seguinte:

Console

Abra a IU da Web do BigQuery no Console do GCP.

Acessar o Console do GCP
Insira a consulta SQL padrão a seguir na caixa Editor de consultas. INFORMATION_SCHEMA requer sintaxe SQL padrão. SQL padrão é a sintaxe padrão no Console do GCP.
```
SELECT
 table_name, view_definition, use_standard_sql
FROM
 mydataset.INFORMATION_SCHEMA.VIEWS
WHERE
 table_name="myview"
```
Observação: os nomes de visualização INFORMATION_SCHEMA diferenciam maiúsculas e minúsculas.
Clique em Executar.

CLI

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.
Para uma visão geral de INFORMATION_SCHEMA, acesse Introdução ao INFORMATION_SCHEMA do BigQuery.

Esta página foi útil? Conte sua opinião sobre:

Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see our Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Última atualização: Setembro 30, 2019.

Como receber informações sobre visualizações

Permissões necessárias

Como receber informações sobre visualizações

Console

IU clássica

CLI

API

Go

Python

INFORMATION_SCHEMA (beta)

Visualização VIEWS

Exemplos

Exemplo 1:

Console

CLI

Exemplo 2:

Console

CLI

Próximas etapas

Enviar comentários sobre…

`INFORMATION_SCHEMA` (beta)

Visualização `VIEWS`