En este documento, se describe cómo enumerar conjuntos de datos en BigQuery.
Puedes enumerar conjuntos de datos de las siguientes maneras:
- Usa Cloud Console.
- Usa el comando
bq ls
en la herramienta de línea de comandos debq
. - Mediante una llamada al método de la API
datasets.list
- Usa las bibliotecas cliente.
Permisos necesarios
Cuando creas una lista de conjuntos de datos, solo se muestran aquellos en los que tienes permisos bigquery.datasets.get
. Las siguientes funciones predefinidas de IAM incluyen los permisos bigquery.datasets.get
:
bigquery.user
bigquery.metadataViewer
bigquery.dataViewer
bigquery.dataOwner
bigquery.dataEditor
bigquery.admin
Para obtener más información sobre las funciones y permisos de IAM en BigQuery, consulta Control de acceso.
Haz una lista de los conjuntos de datos en un proyecto
Para enumerar los conjuntos de datos en un proyecto, haz lo siguiente:
Console
En el menú de navegación, haz clic en Lugar de trabajo SQL.
En el panel Explorador, expande el nombre de un proyecto a fin de ver los conjuntos de datos en ese proyecto o usa el cuadro de búsqueda para buscar por nombre de conjunto de datos.
bq
Ingresa el comando bq ls
para enumerar los conjuntos de datos según el ID del conjunto de datos. Se puede usar la marca --format
para controlar el resultado. Para enumerar conjuntos de datos en un proyecto que no es el predeterminado, agrega la marca --project_id
al comando.
Para enumerar todos los conjuntos de datos de un proyecto, incluidos los conjuntos de datos anónimos, usa la marca --all
o el acceso directo -a
.
Para enumerar todos los conjuntos de datos de un proyecto, excepto los conjuntos de datos anónimos, usa la marca --datasets
o el acceso directo -d
. Esta marca es opcional. Como configuración predeterminada, no se enumeran los conjuntos de datos anónimos.
Las marcas adicionales incluyen las siguientes:
--filter
: Muestra una lista de los conjuntos de datos que coinciden con la expresión de filtro. Usa una lista de claves de etiquetas y valores separados por espacios en el formatolabels.key:value
. Para obtener más información sobre cómo filtrar conjuntos de datos con etiquetas, consulta cómo agregar y usar etiquetas.--max_results
o-n
: Un número entero que indica la cantidad máxima de resultados. El valor predeterminado es50
.
bq ls --filter labels.key:value \ --max_results integer \ --format=prettyjson \ --project_id project_id
Reemplaza lo siguiente:
- key:value es una clave de etiqueta y un valor.
- integer es un número entero que representa la cantidad de conjuntos de datos que se deben incluir en la lista.
- project_id es el nombre de tu proyecto.
Ejemplos:
Ingresa el comando siguiente para enumerar todos los conjuntos de datos en tu proyecto predeterminado. --
format
se configura como “descriptivo” para que se muestre una tabla con formato básico.
bq ls --format=pretty
Ingresa el siguiente comando para enumerar conjuntos de datos de myotherproject
. --format
se configura como prettyjson
para que se muestren resultados detallados en formato JSON.
bq ls --format=prettyjson --project_id myotherproject
Ingresa el siguiente comando para enumerar todos los conjuntos de datos, incluidos los conjuntos de datos anónimos de tu proyecto predeterminado. En el resultado, los conjuntos de datos anónimos comienzan con un guion bajo.
bq ls -a
Ingresa el siguiente comando para mostrar más que el resultado predeterminado de 50 conjuntos de datos de tu proyecto predeterminado.
bq ls --max_results 60
Ingresa el siguiente comando para enumerar conjuntos de datos de tu proyecto predeterminado con la etiqueta org:dev
.
bq ls --filter labels.org:dev
API
Para enumerar conjuntos de datos con la API, realiza una llamada al método de API datasets.list
.
C#
Antes de probar este ejemplo, sigue las instrucciones de configuración para C# incluidas en la guía de inicio rápido de BigQuery sobre cómo usar bibliotecas cliente. Si deseas obtener más información, consulta la documentación de referencia de la API de C# de BigQuery.
Comienza a usarlo
Antes de probar este ejemplo, sigue las instrucciones de configuración para Go que se encuentran en la guía de inicio rápido de BigQuery sobre cómo usar bibliotecas cliente. Si deseas obtener más información, consulta la documentación de referencia de la API de Go de BigQuery.
Java
Antes de probar este ejemplo, sigue las instrucciones de configuración para Java que se encuentran en la guía de inicio rápido de BigQuery sobre cómo usar bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de BigQuery para Java.
Node.js
Antes de probar este ejemplo, sigue las instrucciones de configuración para Node.js que se encuentran en la guía de inicio rápido de BigQuery sobre cómo usar bibliotecas cliente. Para obtener más información, consulta la Documentación de referencia de la API de Node.js de BigQuery.
PHP
Antes de probar este ejemplo, sigue las instrucciones de configuración para PHP incluidas en la guía de inicio rápido de BigQuery sobre cómo usar bibliotecas cliente. Si deseas obtener más información, consulta la documentación de referencia de la API de PHP de BigQuery.
Python
Antes de probar esta muestra, sigue las instrucciones de configuración para Python incluidas en la Guía de inicio rápido de BigQuery sobre cómo usar bibliotecas cliente. Si deseas obtener más información, consulta la documentación de referencia de la API de Python de BigQuery.
Ruby
Antes de probar este ejemplo, sigue las instrucciones de configuración para Ruby incluidas en la guía de inicio rápido de BigQuery sobre cómo usar bibliotecas cliente. A fin de obtener más información, consulta la documentación de referencia de la API de BigQuery para Ruby.
Próximos pasos
- Para obtener más información sobre la creación de conjuntos de datos, consulta Crea conjuntos de datos.
- Para obtener más información sobre cómo asignar controles de acceso a los conjuntos de datos, consulta Controla el acceso a los conjuntos de datos.
- Para obtener más información sobre los metadatos en conjuntos de datos, consulta Obtén información sobre los conjuntos de datos.
- Para obtener más información sobre el cambio de las propiedades de un conjunto de datos, consulta Actualiza los conjuntos de datos.
- Para obtener más información sobre cómo crear y administrar etiquetas, consulta cómo crear y administrar etiquetas.