Listar conjuntos de dados

Este documento descreve como apresentar e obter informações sobre conjuntos de dados no BigQuery.

Antes de começar

Conceda funções de gestão de identidade e de acesso (IAM) que dão aos utilizadores as autorizações necessárias para realizar cada tarefa neste documento.

Função necessária

Para receber a autorização de que precisa para apresentar conjuntos de dados ou receber informações sobre conjuntos de dados, peça ao seu administrador para lhe conceder a função do IAM Visualizador de metadados do BigQuery (roles/bigquery.metadataViewer) no seu projeto. Para mais informações sobre a atribuição de funções, consulte o artigo Faça a gestão do acesso a projetos, pastas e organizações.

Esta função predefinida contém a autorização bigquery.datasets.get , que é necessária para listar conjuntos de dados ou obter informações sobre conjuntos de dados.

Também pode obter esta autorização com funções personalizadas ou outras funções predefinidas.

Quando aplica a função roles/bigquery.metadataViewer ao nível do projeto ou da organização, pode listar todos os conjuntos de dados no projeto. Quando aplica a função roles/bigquery.metadataViewer ao nível do conjunto de dados, pode listar todos os conjuntos de dados para os quais lhe foi concedida essa função.

Liste conjuntos de dados

Selecione uma das seguintes opções:

Consola

  1. No menu de navegação, clique em Studio.

  2. No painel esquerdo, clique em Explorador:

    Botão realçado para o painel do explorador.

  3. No painel Explorador, expanda um projeto, clique em Conjuntos de dados para ver os conjuntos de dados nesse projeto e, de seguida, clique no nome do seu conjunto de dados. Também pode usar o campo de pesquisa ou os filtros para encontrar o seu conjunto de dados.

SQL

Consulte a vista INFORMATION_SCHEMA.SCHEMATA:

  1. Na Google Cloud consola, aceda à página BigQuery.

    Aceda ao BigQuery

  2. No editor de consultas, introduza a seguinte declaração:

    SELECT
  schema_name
FROM
  PROJECT_ID.`region-REGION`.INFORMATION_SCHEMA.SCHEMATA;

    Substitua o seguinte:

    • PROJECT_ID: o ID do seu projeto do Google Cloud . Se não for especificado, é usado o projeto predefinido.
    • REGION: qualquer nome da região do conjunto de dados. Por exemplo, us.

  3. Clique em Executar.

Para mais informações sobre como executar consultas, consulte o artigo Execute uma consulta interativa.

bq

Execute o comando bq ls para listar os conjuntos de dados por ID do conjunto de dados. A flag --format pode ser usada para controlar a saída. Se estiver a listar o conjunto de dados num projeto diferente do projeto predefinido, adicione a flag --project_id ao comando.

Para listar todos os conjuntos de dados num projeto, incluindo conjuntos de dados ocultos, use a flag --all ou o atalho -a.

Para listar todos os conjuntos de dados num projeto, excluindo os conjuntos de dados ocultos, use a flag --datasets ou o atalho -d. Esta flag é opcional. Por predefinição, os conjuntos de dados ocultos não são apresentados.

As flags adicionais incluem:

  • --filter: apresenta os conjuntos de dados que correspondem à expressão de filtro. Use uma lista de chaves e valores de etiquetas separados por espaços no formato labels.