Exportar los resultados de las consultas a un archivo

En este documento, se describe cómo guardar los resultados de las consultas como un archivo, como CSV o JSON.

Descarga los resultados de las consultas en un archivo local

La herramienta de línea de comandos de bq y la API no admiten la descarga de resultados de consultas en un archivo local.

Para descargar los resultados de las consultas como un archivo CSV o JSON delimitado por saltos de línea, usa la Google Cloud consola:

1. En la Google Cloud consola de, abre la página de BigQuery.

   Ir a BigQuery

2. Haz clic en Consulta en SQL.

3. Escribe una consulta válida de GoogleSQL en el área de texto del Editor de consultas.

4. Opcional: Para cambiar la ubicación de procesamiento, haz clic en Más y selecciona Configuración de consulta. En Ubicación de los datos, elige la ubicación de tus datos.

5. Haz clic en Ejecutar.

6. Cuando se muestren los resultados, haz clic en Guardar resultados y selecciona el formato o la ubicación en los que desees guardarlos.

   El archivo se descarga en la ubicación de descarga predeterminada de tu navegador.

Cómo guardar los resultados de las consultas en Google Drive

Beta

Esta función está sujeta a las "Condiciones de la oferta de la fase previa a la DG" en la sección Condiciones del servicio generales de las Condiciones específicas del servicio. Las funciones de la fase previa a la DG están disponibles “sin modificaciones” y pueden tener asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

La herramienta de línea de comandos de bq o la API no admiten que los resultados de las consultas se guarden en Google Drive.

Es posible que recibas un error cuando intentes guardar los resultados de BigQuery en Google Drive. Este error se debe a que la API del SDK de Drive no puede acceder a Google Workspace. Para resolver el problema, debes habilitar tu cuenta de usuario a fin de acceder a Google Drive con la API del SDK de Drive.

Para guardar los resultados de las consultas en Google Drive, usa la Google Cloud consola:

1. En la Google Cloud consola de, abre la página de BigQuery.

   Ir a BigQuery

2. Haz clic en Consulta en SQL.

3. Escribe una consulta válida de GoogleSQL en el área de texto del Editor de consultas.

4. Haz clic en Ejecutar.

5. Cuando se muestren los resultados, haz clic en Guardar resultados.

6. En Google Drive, selecciona CSV o JSON. Cuando guardas los resultados en Google Drive, no puedes elegir la ubicación. Los resultados siempre se guardan en la ubicación raíz "Mi unidad".

7. Guardar los resultados en Google Drive puede tardar unos minutos. Cuando se guardan los resultados, recibes un mensaje de diálogo que incluye el nombre del archivo: bq-results-[TIMESTAMP]-[RANDOM_CHARACTERS].[CSV or JSON].

   

8. En el cuadro de diálogo, haz clic en Abrir para abrir el archivo o navega hasta Google Drive y haz clic en Mi unidad.

Cómo guardar los resultados de las consultas en Hojas de cálculo de Google

La herramienta de línea de comandos de bq y la API no admiten que los resultados de las consultas se guarden en Hojas de cálculo de Google.

Es posible que recibas un error cuando intentes abrir los resultados de BigQuery desde Hojas de cálculo de Google. Este error se debe a que la API del SDK de Drive no puede acceder a Google Workspace. A fin de resolver el problema, debes habilitar tu cuenta de usuario para acceder a Hojas de cálculo de Google con la API del SDK de Drive.

Para guardar los resultados de las consultas en Hojas de cálculo de Google, usa la Google Cloud consola:

1. En la Google Cloud consola de, abre la página de BigQuery.

   Ir a BigQuery

2. Haz clic en Consulta en SQL.

3. Escribe una consulta válida de GoogleSQL en el área de texto del Editor de consultas.

4. Opcional: Para cambiar la ubicación de procesamiento, haz clic en Más y selecciona Configuración de consulta. En Ubicación de los datos, elige la ubicación de tus datos.

5. Haz clic en Ejecutar.

6. Cuando se muestren los resultados, haz clic en Guardar los resultados y selecciona Hojas de cálculo de Google.

7. Si es necesario, sigue las indicaciones para acceder a tu cuenta de usuario y haz clic en Permitir si quieres permitir que se escriban los datos en tu carpeta de Google Drive My Drive.

   Tras seguir las indicaciones, deberías recibir un correo electrónico en el que se confirme que las herramientas cliente de BigQuery se conectaron a tu cuenta de usuario. El correo electrónico contiene información sobre los permisos que otorgaste y los pasos que tienes que seguir para quitarlos.

8. Cuando se guardan los resultados, debajo de los resultados de las consultas aparece un mensaje similar al siguiente en la Google Cloud consola: Saved to Sheets as "results-20190225-103531". Haz clic en el vínculo del mensaje para ver tus resultados en Hojas de cálculo de Google o navega a tu My Drive carpeta y abre el archivo de forma manual.

   Cuando guardas los resultados de las consultas en las Hojas de cálculo de Google, el nombre del archivo comienza con results-[DATE] donde [DATE] es la fecha de hoy en el formato YYYYMMDD.

   Nota: Ni la herramienta de línea de comandos de bq ni la API admiten que los resultados se guarden en Hojas de cálculo de Google. Para obtener más información, consulta Usa Hojas conectadas.

Soluciona problemas para guardar resultados en Hojas de cálculo de Google

Cuando guardes datos de BigQuery en Hojas de cálculo de Google, es posible que algunas celdas de las hojas estén en blanco. Esto sucede cuando los datos que escribes en la celda superan el límite de 50,000 caracteres de Hojas de cálculo de Google. Para resolver esto, usa una función de string en la consulta de GoogleSQL para dividir la columna con los datos largos en dos o más columnas y, luego, vuelve a guardar el resultado en hojas de cálculo.

Guarda los resultados de las consultas en Cloud Storage

Puedes exportar los resultados de las consultas a Cloud Storage en la Google Cloud consola con los siguientes pasos:

1. Abre la página de BigQuery en la Google Cloud consola.

   Ir a la página de BigQuery

2. Haz clic en Consulta en SQL.

3. Escribe una consulta válida de GoogleSQL en el área de texto del Editor de consultas.

4. Haz clic en Ejecutar.

5. Cuando se muestren los resultados, haz clic en Guardar resultados > Cloud Storage.

6. Sigue estos pasos en el diálogo Exportar a Google Cloud Storage:

   • En Ubicación de GCS, busca el bucket, la carpeta o el archivo al que quieres exportar los datos.
   • En Formato de exportación, selecciona el formato de los datos exportados: CSV, JSON (delimitado por saltos de línea), Avro o Parquet.
   • En Compresión, selecciona un formato de compresión o selecciona None para no comprimir.

7. Haz clic en Guardar para exportar los resultados de las consultas.

Para verificar el progreso del trabajo, expande el panel Historial de trabajos y busca el trabajo con el tipo EXTRACT.

Restringe la descarga de resultados de consultas

Para evitar que los usuarios descarguen los resultados de las consultas desde la Google Cloud consola, usa uno de los siguientes métodos:

• Configura un perímetro de Controles del servicio de VPC para evitar el robo de datos. Esto impide que los usuarios descarguen y exporten datos fuera de los límites del perímetro establecidos.

• Comunícate con Atención al cliente de Cloud para solicitar que tu Google Cloud proyecto o tu organización se agreguen a una lista restringida. Esto inhabilita las opciones de descarga y exportación de datos directamente en la Google Cloud consola.

¿Qué sigue?

• Obtén información para exportar una tabla a un archivo JSON de manera programática.
• Obtén más información sobre las cuotas para trabajos de extracción.
• Obtén más información sobre los precios de almacenamiento de BigQuery.