Como listar visualizações

Neste documento, descrevemos como listar visualizações no BigQuery.

Para listar visualizações em conjuntos de dados:

• use o Console do GCP ou a IU clássica da Web do BigQuery;
• Use o comando bq ls da CLI.
• Chame o método de API tables.list.
• Use bibliotecas de cliente.

Permissões exigidas

Para listar visualizações de um conjunto de dados, é necessário ter, no mínimo, permissões bigquery.tables.list. Os papéis predefinidos do Cloud IAM a seguir incluem permissões bigquery.tables.list:

• bigquery.user
• bigquery.metadataViewer
• bigquery.dataViewer
• bigquery.dataOwner
• bigquery.dataEditor
• bigquery.admin

Para mais informações sobre os papéis e as permissões do Cloud IAM no BigQuery, consulte Permissões e papéis 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

1. No painel de navegação, na seção Recursos, expanda seu projeto e clique em um conjunto de dados. Isso exibe as tabelas e visualizações no conjunto de dados.

2. Percorra a lista para ver as tabelas no conjunto de dados. Tabelas e visualizações são identificadas por ícones diferentes.

   

IU clássica

1. No painel de navegação da IU da Web do BigQuery, clique na seta azul à esquerda do conjunto de dados para expandi-lo ou clique duas vezes no nome dele. Isso exibe as tabelas e visualizações no conjunto de dados.

2. Percorra a lista para ver as tabelas no conjunto de dados. As tabelas e visualizações são identificadas por diferentes ícones.

   

CLI

Emita o comando bq ls. A sinalização --format pode ser usada para controlar a saída. Se você estiver listando visualizações em um projeto diferente do padrão, adicione o 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.

Ao executar 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 seguinte comando para listar as visualizações no conjunto de dados mydataset no seu projeto padrão.

bq ls --format=pretty mydataset

Digite o seguinte comando para listar as visualizações no conjunto de dados mydataset em myotherproject.

bq ls --format=pretty myotherproject:mydataset

API

Para listar as visualizações usando a API, chame o método tables.list.

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")
ts := client.Dataset(datasetID).Tables(ctx)
for {
	t, err := ts.Next()
	if err == iterator.Done {
		break
	}
	if err != nil {
		return err
	}
	fmt.Fprintf(w, "Table: %q\n", t.TableID)
}

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

# TODO(developer): Construct a BigQuery client object.
# client = bigquery.Client()

# TODO(developer): Set dataset_id to the ID of the dataset that contains
#                  the tables you are listing.
# dataset_id = 'your-project.your_dataset'

tables = client.list_tables(dataset_id)

print("Tables contained in '{}':".format(dataset_id))
for table in tables:
    print("{}.{}.{}".format(table.project, table.dataset_id, table.table_id))

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.