Neste documento, descrevemos como listar visualizações no BigQuery.
Para listar visualizações em conjuntos de dados:
- Como usar o Console do Cloud
- use o comando
bq ls
na ferramenta de linha de comandobq
; - Chame o
tables.list
método de API - usar as bibliotecas de cliente.
Permissões necessárias
Para listar visualizações em um conjunto de dados, é preciso ter pelo menos
as permissões bigquery.tables.list
. Os seguintes papéis predefinidos do IAM incluem as permissões bigquery.tables.list
:
bigquery.user
bigquery.metadataViewer
bigquery.dataViewer
bigquery.dataOwner
bigquery.dataEditor
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 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.
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.
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.