Como listar conjuntos de dados
Neste documento, descrevemos como listar conjuntos de dados no BigQuery.
É possível listar conjuntos de dados das seguintes maneiras:
- Usando o console
- Usando a consulta SQL
INFORMATION_SCHEMA
. - use o comando
bq ls
na ferramenta de linha de comandobq
. - Chamada do método de API
datasets.list
- usando 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 conjuntos de dados, você precisa da permissão bigquery.datasets.get
do IAM.
Cada um dos seguintes papéis predefinidos do IAM inclui as permissões necessárias para criar uma visualização:
roles/bigquery.user
roles/bigquery.dataOwner
roles/bigquery.dataEditor
roles/bigquery.admin
Além disso, roles/bigquery.metadataViewer
e roles/bigquery.dataViewer
, quando aplicados no nível do projeto ou da organização, podem listar todos os conjuntos de dados no projeto.
Para mais informações sobre papéis e permissões do IAM no BigQuery, consulte Papéis e permissões predefinidos.
Como listar conjuntos de dados em um projeto
Para listar os conjuntos de dados em um projeto, faça o seguinte:
Console
No menu de navegação, clique em Espaço de trabalho do SQL.
No painel Explorador, expanda um nome de projeto para ver os conjuntos de dados dele ou use a caixa de pesquisa para procurar pelo nome do conjunto de dados.
SQL
Consulte a visualização INFORMATION_SCHEMA.SCHEMATA
.
No console, acesse a página BigQuery.
No editor de consultas, digite a seguinte instrução:
SELECT schema_name FROM PROJECT_ID.INFORMATION_SCHEMA.SCHEMATA;
Substitua:
- PROJECT_ID: o ID do projeto para listar os conjuntos de dados disponíveis.
Clique em
Executar.
Para informações sobre como executar consultas, consulte Como executar consultas interativas.
bq
Emita o comando bq ls
para listar conjuntos de dados pelo ID deles. A sinalização --format
pode ser usada para controlar a saída. Se você estiver listando o conjunto de dados em um projeto diferente do padrão, adicione a sinalização --project_id
ao comando.
Para listar todos os conjuntos de dados em um projeto, incluindo conjuntos de dados anônimos, use a sinalização --all
ou o atalho -a
.
Para listar todos os conjuntos de dados em um projeto, mas sem conjuntos de dados anônimos, use a sinalização --datasets
ou o atalho -d
. Essa sinalização é opcional. Por padrão, os conjuntos de dados anônimos não são listados.
Veja a seguir algumas outras sinalizações:
--filter
: conjuntos de dados de listas que correspondem à expressão do filtro. Use uma lista separada por espaço de chaves e valores de rótulo no formatolabels.key:value
. Para mais informações sobre como filtrar conjuntos de dados usando rótulos, consulte Como adicionar e usar rótulos.--max_results
ou-n
: um número inteiro que indica o valor máximo de resultados. O valor padrão é50
.
bq ls --filter labels.key:value \ --max_results integer \ --format=prettyjson \ --project_id project_id
Substitua:
- key:value: chave e valor de um identificador;
- integer: um número inteiro que representa a quantidade de conjuntos de dados a serem listados;
- project_id: o nome do projeto.
Exemplos:
Digite o comando a seguir para listar conjuntos de dados no projeto padrão. --
format
é definido como pretty para retornar uma tabela formatada básica.
bq ls --format=pretty
Insira o seguinte comando para listar conjuntos de dados em myotherproject
. --format
é definido como prettyjson
para retornar resultados detalhados no formato JSON.
bq ls --format=prettyjson --project_id myotherproject
Insira o comando a seguir para listar todos os conjuntos de dados, incluindo conjuntos de dados anônimos no projeto padrão. Na saída, os conjuntos de dados anônimos começam com um sublinhado.
bq ls -a
Digite o comando a seguir para retornar mais de 50 conjuntos de dados do seu projeto, que é a saída padrão.
bq ls --max_results 60
Digite o comando a seguir para listar os conjuntos de dados no projeto padrão com o rótulo org:dev
.
bq ls --filter labels.org:dev
API
Para listar conjuntos de dados usando a API, chame o método datasets.list
da API.
C#
Antes de testar esta amostra, siga as instruções de configuração do C# 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 C#.
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.
Java
Antes de testar esta amostra, siga as instruções de configuração do 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 esta amostra, siga as instruções de configuração do 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.
PHP
Antes de testar esta amostra, siga as instruções de configuração do PHP 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 PHP.
Python
Antes de testar esta 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.
Ruby
Antes de testar esta amostra, siga as instruções de configuração para Ruby 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 Ruby.
Segurança do conjunto de dados
Para controlar o acesso a conjuntos de dados no BigQuery, consulte Como controlar o acesso a conjuntos de dados. Para saber mais sobre criptografia de dados, consulte Criptografia em repouso.
Próximas etapas
- Para mais informações sobre a criação de conjuntos de dados, consulte Como criar conjuntos de dados.
- Para mais informações sobre metadados do conjunto de dados, consulte Como receber informações sobre conjuntos de dados.
- Para mais informações sobre como mudar as propriedades do conjunto de dados, consulte Como atualizar as propriedades do conjunto de dados.
- Para mais informações sobre como criar e gerenciar rótulos, consulte esta página.