Como listar visualizações
Neste documento, descrevemos como listar visualizações no BigQuery.
Para listar visualizações em conjuntos de dados:
- Como usar o console do Google Cloud
- use o comando
bq ls
na ferramenta de linha de comandobq
; - Chame o
tables.list
método de API - use bibliotecas de cliente.
Antes de começar
Atribua papéis do Identity and Access Management (IAM) que concedam aos usuários as permissões necessárias para realizar cada tarefa deste documento.
Permissões necessárias
Para listar visualizações em um conjunto de dados, você precisa da permissão bigquery.tables.list
do IAM.
Cada um dos papéis predefinidos do IAM a seguir inclui as permissões necessárias para listar as visualizações em um conjunto de dados:
roles/bigquery.user
roles/bigquery.metadataViewer
roles/bigquery.dataViewer
roles/bigquery.dataOwner
roles/bigquery.dataEditor
roles/bigquery.admin
Para mais informações sobre papéis e permissões do IAM no BigQuery, consulte Papéis e permissões predefinidos.
Como listar visualizações
O procedimento para listar visualizações é igual ao usado para tabelas.
Para listar as visualizações em um conjunto de dados:
Console
No painel Explorer, expanda o projeto e selecione um conjunto de dados.
Percorra a lista para ver as tabelas no conjunto de dados. Tabelas e visualizações são identificadas por ícones diferentes.
bq
Emita o comando bq ls
. A sinalização --format
pode ser usada para controlar
a saída. Se estiver listando visualizações em um projeto diferente do seu projeto padrão,
adicione a ID do projeto ao conjunto de dados no seguinte formato:
project_id:dataset
.
bq ls --format=pretty project_id:dataset
Em que:
- project_id é o ID do projeto;
- dataset é o nome do conjunto de dados.
Quando você executa o comando, o campo Type
exibe TABLE
ou
VIEW
. Por exemplo:
+-------------------------+-------+----------------------+-------------------+ | tableId | Type | Labels | Time Partitioning | +-------------------------+-------+----------------------+-------------------+ | mytable | TABLE | department:shipping | | | myview | VIEW | | | +-------------------------+-------+----------------------+-------------------+
Exemplos:
Digite o comando a seguir para listar visualizações no conjunto de dados mydataset
no seu projeto padrão.
bq ls --format=pretty mydataset
Digite o comando a seguir para listar visualizações no conjunto de dados mydataset
em myotherproject
.
bq ls --format=pretty myotherproject:mydataset
API
Para listar visualizações usando a API, utilize o método tables.list
.
Go
Antes de testar esta amostra, 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 em Go.
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 em Python.
Segurança das visualizações
Para controlar o acesso a visualizações no BigQuery, consulte Visualizações autorizadas.
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 como receber metadados de visualizações, consulte Como receber informações sobre 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.