Explora BigQuery en la consola de Google Cloud

BigQuery en la consola de Google Cloud es una interfaz gráfica en la que puedes crear y administrar tus recursos de BigQuery. Puedes usar la consola de Google Cloud para ver tablas y conjuntos de datos, crear y ejecutar consultas en SQL, compilar canalizaciones y realizar otras tareas que te ayuden a administrar tus flujos de trabajo de BigQuery.

Antes de comenzar

  1. Accede a tu cuenta de Google Cloud . Si eres nuevo en Google Cloud, crea una cuenta para evaluar el rendimiento de nuestros productos en situaciones reales. Los clientes nuevos también obtienen $300 en créditos gratuitos para ejecutar, probar y, además, implementar cargas de trabajo.

  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  3. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

    4.

  4. Habilita la API de BigQuery si aún no está habilitada.

    Roles necesarios para habilitar las APIs

    Para habilitar las APIs, necesitas el permiso serviceusage.services.enable. Si creaste el proyecto, es probable que ya tengas este permiso a través del rol de propietario (roles/owner). De lo contrario, puedes obtenerlo a través del rol de administrador de Service Usage (roles/serviceusage.serviceUsageAdmin). Obtén más información para otorgar roles.

    Habilitar la API

    Para los proyectos nuevos, la API de BigQuery se habilita de forma automática.

  5. Opcional: Habilita la facturación para el proyecto. Si no deseas habilitar la facturación ni proporcionar una tarjeta de crédito, los pasos que se indican en este documento seguirán funcionando. BigQuery proporciona una zona de pruebas para realizar los pasos. Para obtener más información, consulta Habilita la zona de pruebas de BigQuery.

Abre la Google Cloud consola.

  1. Accede a la consola de Google Cloud .

    Ir a la consola

  2. En la barra de herramientas de la consola de Google Cloud , haz clic en Menú de navegación.

  3. Haz clic en Soluciones > Todos los productos.

  4. En la sección Análisis, haz clic en BigQuery.

    Se abrirá la página Studio de BigQuery.

  5. Para controlar el menú de navegación de BigQuery, realiza una de las siguientes acciones:

    • Para expandir el menú de navegación, mantén el puntero sobre el ícono Ícono del menú de navegación de BigQuery. y, luego, haz clic en left_panel_open Activar o desactivar el menú de navegación de BigQuery.

    • Para contraer el menú de navegación, haz clic en left_panel_close Activar o desactivar el menú de navegación de BigQuery.

Puedes usar el menú de navegación para abrir las siguientes páginas:

  • Descripción general: Te permite descubrir instructivos, funciones y recursos.
  • Studio: Te permite mostrar tus recursos de BigQuery y realizar tareas comunes.
  • Búsqueda (versión preliminar): Te permite buscar recursos de Google Cloud desde BigQuery con consultas en lenguaje natural.
  • Agentes (versión preliminar): Te permite crear agentes de datos y chatear con ellos. Estos agentes están diseñados para responder preguntas sobre los recursos de BigQuery.

También puedes usar el menú de navegación para realizar tareas específicas en las siguientes secciones del menú:

La página de BigQuery Studio

En la página Studio de BigQuery, se muestran tus recursos de BigQuery y puedes realizar tareas comunes. La página de Studio tiene los siguientes componentes:

Los componentes de BigQuery Studio

  1. Pestaña Explorador del panel izquierdo: Usa la pestaña Explorador para trabajar con tablas, vistas, rutinas y otros recursos de BigQuery, y ver tu historial de trabajos.

    El panel izquierdo también contiene una opción para agregar datos a BigQuery. Cuando haces clic en Agregar datos, puedes usar las funciones de búsqueda y filtrado para encontrar una fuente de datos con la que quieras trabajar. Después de seleccionar una fuente de datos, puedes hacer lo siguiente según las capacidades disponibles para tu fuente de datos:

    Para obtener más información sobre la carga de datos en BigQuery, consulta Introducción a la carga de datos.

  2. Pestaña Explorador clásico del panel izquierdo: Usa la versión heredada del panel Explorador para ver los recursos de BigQuery.

  3. Pestaña Archivos del panel izquierdo (vista previa): usa la pestaña Archivos para organizar los recursos de código, como las consultas guardadas y los notebooks, con carpetas. Para obtener más información, consulta Cómo organizar los recursos de código con carpetas.

  4. Pestaña Repositorio del panel izquierdo (versión preliminar): usa la pestaña Repositorio para almacenar código, editar archivos y realizar un seguimiento de los cambios con el control de versión a través de repositorios o con repositorios remotos basados en Git. Para obtener más información, consulta Introducción a los repositorios.

  5. Pestaña Página principal: Usa la pestaña Página principal para ver los siguientes recursos:

    • La sección Descubre las novedades de Studio, en la que se enumeran las funciones nuevas de BigQuery Studio Puedes hacer clic en Probar para ver las funciones. Si la sección no está visible, haz clic en What's new in Studio para expandirla.
    • La sección Crear, que tiene opciones para crear una consulta en SQL, un notebook, un notebook de Apache Spark, un lienzo de datos, un archivo de preparación de datos, una canalización o una tabla nuevos.
    • La sección Recientes, en la que puedes ver los 10 recursos a los que accediste más recientemente Estos recursos incluyen tablas, consultas guardadas, modelos y rutinas.
    • La sección Prueba con plantillas, que te permite usar plantillas para comenzar a consultar datos y trabajar con notebooks.
    • La sección Agrega tus propios datos, que te ayuda a comenzar a cargar datos en BigQuery

  6. Editor de consultas: Usa el editor de consultas para crear y ejecutar una consulta interactiva. También puedes ver los resultados en el panel Resultados de la consulta que se abre después de ejecutar la consulta. Dentro de los resultados de la consulta, el panel Recientes específico de la sesión te permite ver los resultados recientes.

Explora la página de Studio

La página Studio en BigQuery es el punto central para ver tus recursos de BigQuery y realizar tareas comunes, como crear conjuntos de datos y crear y ejecutar notebooks.

Para explorar la página Studio, sigue estos pasos:

  1. En la consola de Google Cloud , ve a la página Studio de BigQuery.

    Ir a Studio

    Como alternativa, ingresa la siguiente URL en tu navegador:

    https://console.cloud.google.com/bigquery

    Se abrirá la página de Studio en el último proyecto al que accediste.

  2. En el panel de la izquierda, haz clic en la pestaña Explorar.

    En el panel Explorador, se enumeran diferentes recursos de código y de datos, y te permite buscar recursos de BigQuery.

  3. Ve al proyecto bigquery-public-data, haz clic en Activar o desactivar nodo para expandirlo y, luego, haz clic en Conjuntos de datos. Se abrirá una pestaña nueva en el panel de detalles que mostrará una lista de todos los conjuntos de datos del proyecto.

    Los conjuntos de datos públicos de BigQuery se almacenan en BigQuery y se ponen a disposición del público en general a través del Programa de conjuntos de datos públicos de Google Cloud .

  4. En la lista, haz clic en el conjunto de datos america_health_rankings.

  5. En la pestaña Descripción general, consulta los recursos almacenados en el conjunto de datos, como tablas, modelos y rutinas.

  6. Haz clic en la pestaña Detalles. En esta pestaña, se muestran todos los detalles del conjunto de datos, incluida la información de metadatos.

  7. Para navegar por diferentes pestañas y recursos, usa la ruta de navegación como se muestra en el siguiente ejemplo:

    Rutas de navegación en el panel de detalles.

  8. En el panel Explorador, haz clic en Historial de trabajos. Se abrirá la lista de historiales de trabajos en una pestaña nueva:

    Pestañas para el historial personal, el historial de proyectos y las consultas guardadas.

    Cada vez que cargas, exportas, consultas o copias datos, BigQuery crea, programa y ejecuta automáticamente un trabajo que hace un seguimiento del progreso de la tarea.

    1. Para ver los detalles de tus trabajos, haz clic en Historial personal.

    2. Para ver los detalles de los trabajos recientes de tu proyecto, haz clic en Historial del proyecto.

  9. En el panel izquierdo, haz clic en la pestaña Repositorio folder_data (Vista previa).

    Puedes usar repositorios para realizar el control de versión en los archivos que usas en BigQuery. BigQuery usa Git para registrar cambios y administrar versiones de archivos.

    Puedes usar espacios de trabajo dentro de los repositorios para editar el código almacenado en el repositorio. Cuando haces clic en un espacio de trabajo en el panel Repositorio de Git, se abre en una pestaña del panel de detalles.

  10. En el panel izquierdo, haz clic en Archivos (Vista previa).

    La pestaña Archivos te permite crear carpetas de usuarios y equipos que almacenan y organizan tus recursos de código.

  11. Haz clic en la pestaña Principal .

    En la pestaña Inicio, se proporcionan vínculos y plantillas que te permiten comenzar a usar BigQuery.

    Si cierras la pestaña Principal, puedes abrirla haciendo clic en Principal en la pestaña Explorador.

  12. Haz clic en el editor de consultas. Esta pestaña se etiqueta como search_insights Consulta sin título.

    Usa el editor de consultas para crear consultas en SQL, ejecutarlas y ver los resultados.

    Si cierras el editor de consultas, puedes abrirlo haciendo clic en la pestaña Página principal y, luego, en la sección Crear, haz clic en Consulta en SQL.

Trabaja con pestañas en Studio

Cada vez que seleccionas un recurso o haces clic en Consulta en SQL en el panel de detalles, se abre una pestaña nueva. Si hay más de una pestaña abierta, puedes dividirlas en dos paneles y verlas una al lado de la otra.

Evita que se reemplacen las pestañas

Para reducir la proliferación de pestañas, cuando haces clic en un recurso, se abre en la misma pestaña. Para abrir el recurso en una pestaña separada, sigue estos pasos:

  1. Presiona Ctrl (o Comando en macOS) y haz clic en el recurso.

  2. Como alternativa, haz doble clic en el nombre de la pestaña. El nombre cambia de cursiva a fuente normal.

  3. Si reemplazas la página actual por accidente, puedes encontrarla haciendo clic en tab_recent Pestañas recientes en el panel de detalles.

Cómo dividir y unir pestañas

Para dividir las pestañas en dos paneles, sigue estos pasos:

  1. Junto al nombre de la pestaña, haz clic en Abrir menú.

  2. Selecciona una de las opciones siguientes:

    • Para colocar la pestaña seleccionada en el panel izquierdo, selecciona Dividir pestaña a la izquierda.

    • Para colocar la pestaña seleccionada en el panel derecho, selecciona Dividir pestaña a la derecha.

  3. Para anular la división de las pestañas, selecciona Abrir menú en una de las pestañas abiertas y, luego, selecciona Mover la pestaña al panel izquierdo o Mover la pestaña al panel derecho.

Consulta datos con pestañas divididas

Para dividir las pestañas cuando consultas las tablas, sigue estos pasos:

  1. En el menú Explorador, haz clic en la tabla que deseas consultar.

  2. Haz clic en Consultar y, luego, en En una pestaña nueva o en En una pestaña dividida:

    Opciones para consultar una tabla en una pestaña nueva o dividida.

  3. Haz clic en el nombre del campo que deseas consultar:

    Agrega el nombre del campo a la consulta en una pestaña dividida.

En la siguiente imagen, se muestra el panel de detalles con dos pestañas abiertas. Una pestaña tiene una consulta en SQL y la otra muestra detalles sobre una tabla.

Panel de detalles con dos pestañas abiertas.

Cómo mover pestañas entre paneles

Para mover una pestaña de un panel a otro, sigue estos pasos:

  1. Junto al nombre de la pestaña, haz clic en Abrir menú.

  2. Selecciona Mover pestaña al panel derecho o Mover pestaña al panel izquierdo (la opción que esté disponible).

Cerrar todas las demás pestañas

Para cerrar todas las pestañas, excepto una, sigue estos pasos:

  1. Junto al nombre de la pestaña, haz clic en Abrir menú.

  2. Selecciona Cerrar las demás pestañas.

La página Resumen

La página Descripción general de BigQuery es tu centro para descubrir instructivos, funciones y recursos que te ayudarán a aprovechar al máximo BigQuery. Proporciona rutas guiadas para usuarios de todos los niveles de habilidad, ya sea que ejecutes tu primera consulta o explores capacidades avanzadas de IA/AA.

Puedes usar la página Descripción general para encontrar recursos organizados según tu rol o interés, como análisis de datos o ciencia de datos. Estos recursos te permiten encontrar el contenido más relevante para comenzar rápidamente.

Explora la página Resumen

  1. En la consola, ve a la página Descripción general.

    Ir a Descripción general

    También puedes abrir la página Overview de BigQuery ingresando la siguiente URL en el navegador:

    https://console.cloud.google.com/bigquery/overview

  2. Revisa las siguientes secciones de la página Descripción general:

    • La sección Introducción: te brinda una descripción general rápida en video de las capacidades de BigQuery.

    • La sección Comienza: diseñada para aprender con la práctica. Aquí puedes iniciar guías interactivas que te ayudarán a aprender a usar las funciones de BigQuery.

    • La sección Más información muestra las notas de la versión de BigQuery para que puedas ver los anuncios y las actualizaciones de las funciones más recientes.

    • La sección Explora las posibilidades proporciona tutoriales detallados y oportunidades de aprendizaje para funciones específicas.

Personaliza la página Resumen

Puedes personalizar la página Descripción general para mostrar u ocultar información relevante para tu tarea o rol.

  1. En la página Descripción general, ve a la barra de filtros.

    La barra de filtros en la página Resumen

  2. Haz clic en la opción que mejor se adapte a tu tarea o rol actual:

    • Análisis de datos
    • Ciencia de datos
    • Ingeniería de datos
    • Administración de datos

    Cuando seleccionas una tarea, el contenido de las secciones Introducción, Comenzar y Explorar posibilidades cambia de forma dinámica para mostrar el contenido más relevante.

  3. Opcional: Para adaptar el contenido de la página Resumen a tus necesidades específicas, oculta las tarjetas individuales:

    1. En la tarjeta, haz clic en Más opciones.

    2. Elige Ocultar tarjeta. Tus preferencias para las tarjetas ocultas se guardan por usuario.

    3. Para mostrar la tarjeta, haz clic en Mostrar contenido oculto al final de la sección.

  4. Si una sección completa no es relevante, haz clic en para contraerla. Se guardan tus preferencias de usuario para las secciones contraídas.

La página de búsqueda

La página Search (versión preliminar) te permite buscar Google Cloud recursos de BigQuery con consultas en lenguaje natural.

Si deseas obtener información para habilitar el uso de la página Búsqueda, consulta Cómo buscar recursos.

La página Agents

La página Agentes (vista previa) es una ubicación central para crear agentes de datos y chatear con ellos, diseñados para responder preguntas sobre los recursos de BigQuery.

Los agentes de datos contienen metadatos de tablas y, además, instrucciones de procesamiento de consultas específicas de casos de uso que definen la mejor manera de responder las preguntas de los usuarios sobre un conjunto de tablas que selecciones. Los usuarios pueden tener conversaciones con agentes de datos para hacer preguntas sobre los datos de BigQuery con lenguaje natural. Para obtener más información, consulta Crea agentes de datos.

Para obtener información sobre cómo crear agentes y usar las estadísticas conversacionales, consulta Estadísticas conversacionales en BigQuery.

Limitaciones

La consola de BigQuery Google Cloud no admite la nube privada virtual ni Private Service Connect.

Soluciona problemas de la consola de BigQuery Google Cloud

Si tienes problemas en la consola de Google Cloud cuando usas BigQuery, como páginas que no se cargan, capacidad de respuesta lenta o funciones faltantes, prueba los siguientes pasos para solucionar problemas.

Soluciones habituales para problemas del navegador

Muchos problemas de la consola de Google Cloud se deben a configuraciones locales del navegador o a datos almacenados en caché.

Requisitos de conectividad y firewall

Si trabajas detrás de una VPN o un proxy corporativo, es posible que se bloqueen las llamadas a la API que requiere la consola. Asegúrate de que el administrador de red incluya en la lista de entidades permitidas los siguientes dominios:

  • https://cloudconsole-pa.clients6.google.com
  • https://clients6.google.com
  • https://cloudusersettings-pa.clients6.google.com

Entre los síntomas comunes de los endpoints de API bloqueados, se incluyen un indicador de progreso giratorio para las sugerencias de autocompletado o errores de permisos, a pesar de tener los roles de IAM correctos.

Mejora el rendimiento de los proyectos grandes

Si tu proyecto contiene una gran cantidad de conjuntos de datos o tablas, es posible que la pestaña Explorador se cargue lentamente.

  • Usa el parámetro de carga mínima: Puedes evitar que se precargue el árbol de recursos agregando ?minimal=true a tu URL. Por ejemplo:

    https://console.cloud.google.com/bigquery?minimal=true&project=PROJECT_ID

  • Desfija los proyectos sin usar: Quita los proyectos fijados que no uses de forma activa para reducir la carga en la pestaña Explorador.

  • Forzar la actualización de metadatos: Si modificaste tablas a través de la API o la CLI y los cambios no se muestran en la consola, realiza una actualización forzada (Ctrl + Mayúsculas + R o Cmd + Mayúsculas + R). Usa las búsquedas de INFORMATION_SCHEMA como fuente definitiva de verdad.

Soluciona problemas con mapas y gráficos

  • Geospatial (TinyMap): La pestaña de visualización geoespacial solo está disponible si los resultados de la consulta contienen una columna GEOGRAPHY. La visualización del mapa se limita a un máximo de 20,000 elementos o 1 millón de vértices.
  • Gráficos: Los resultados deben contener al menos una columna numérica para generar gráficos. Si aparece la advertencia "No hay datos para mostrar", verifica si hay valores nulos en la dimensión del eje X seleccionada.

Soluciona problemas de linaje y generación de perfiles de datos

  • Retraso del linaje: La información del linaje de datos no es en tiempo real. Espera hasta 30 minutos para que se sincronicen los datos de linaje.
  • APIs obligatorias: Asegúrate de que la API de Dataplex (dataplex.googleapis.com) y la API de Data Catalog (datacatalog.googleapis.com) estén habilitadas en tu proyecto.

Soluciona problemas de BigQuery Studio y las consultas guardadas

  • Límite de migración de consultas guardadas: Si tienes más de 2,500 consultas guardadas, la herramienta de migración automatizada no puede procesarlas. Comunícate con la Atención al cliente de Cloud para solicitar una migración manual.
  • APIs obligatorias: Para guardar secuencias de comandos y notebooks en BigQuery Studio, se debe habilitar la API de Dataform (dataform.googleapis.com) en tu proyecto.

Comunicarme con el equipo de Asistencia

Si el problema persiste, recopila la siguiente información antes de crear un ticket de asistencia:

  1. Un archivo HAR: Registra el registro de solicitudes de red mientras reproduces el problema (con la pestaña Red de las herramientas para desarrolladores del navegador con la opción Conservar registro marcada).
  2. Registros de la consola: Capturan los errores de JavaScript que se muestran en la consola para desarrolladores del navegador (Ctrl + Mayúsculas + I > Consola).
  3. ID del proyecto: Es el ID del proyecto en el que estás trabajando.
  4. Número de seguimiento: Es el ID de seguimiento que se muestra en los banners de error.

¿Qué sigue?