Usa la IU web de BigQuery

BigQuery expone una IU web gráfica en Cloud Console que puedes usar para crear y administrar recursos de BigQuery y ejecutar consultas de SQL.

Consulta la guía de inicio rápido sobre la IU web de BigQuery para obtener una introducción de trabajo a la IU web.

Antes de comenzar

Antes de poder usar la IU web de BigQuery, debes crear o seleccionar un proyecto y habilitar la facturación con Cloud Console.

  1. Sign in to your Google Account.

    If you don't already have one, sign up for a new account.

  2. Select or create a Google Cloud Platform project.

    Go to the Manage resources page

  3. Comprueba que la facturación esté habilitada en tu proyecto.

    Descubre cómo puedes habilitar la facturación

  4. BigQuery se habilita de forma automática en proyectos nuevos. Para activar BigQuery en un proyecto preexistente, {% dynamic if "no_credentials" in setvar.task_params %} {% dynamic setvar credential_type %}NO_AUTH{% dynamic endsetvar %} {% dynamic if not setvar.redirect_url %} {% dynamic setvar redirect_url %}https://console.cloud.google.com{% dynamic endsetvar %} {% dynamic endif %}{% dynamic endif %} {% dynamic if setvar.in_henhouse_no_auth_whitelist %} {% dynamic if not setvar.credential_type %}{% dynamic setvar credential_type %}NO_AUTH{% dynamic endsetvar %} {% dynamic endif %} {% dynamic elif setvar.in_henhouse_service_account_whitelist %} {% dynamic if not setvar.credential_type %}{% dynamic setvar credential_type %}SERVICE_ACCOUNT{% dynamic endsetvar %} {% dynamic endif %}{% dynamic endif %} {% dynamic if not setvar.service_account_roles and setvar.credential_type == "SERVICE_ACCOUNT" %} {% dynamic setvar service_account_roles %} {% dynamic endsetvar %} {% dynamic endif %} {% dynamic setvar console %} {% dynamic if "no_steps" not in setvar.task_params %}
  5. {% dynamic endif %} {% dynamic if setvar.api_list %} {% dynamic if setvar.in_henhouse_no_auth_whitelist or setvar.in_henhouse_service_account_whitelist %} Configurar un proyecto de GCP Console.

    Configurar un proyecto

    Haz clic para realizar alguna de las siguientes acciones:

    • Crear o seleccionar un proyecto.
    • Habilitar las {% dynamic if setvar.api_names %}{% dynamic print setvar.api_names %}{% dynamic else %}{% dynamic endif %}{% dynamic if "," in setvar.api_list %} API{% dynamic elif "API" in setvar.api_names %}{% dynamic else %} API{% dynamic endif %} necesarias para el proyecto.
    • {% dynamic if setvar.credential_type == 'SERVICE_ACCOUNT' %}
    • Crear una cuenta de servicio.
    • Descargar una clave privada como JSON.
    • {% dynamic endif %}

    Puedes visualizar y administrar estos recursos en GCP Console en cualquier momento.

    {% dynamic else %}{% dynamic if "no_text" not in setvar.task_params %} Habilita las {% dynamic if setvar.api_names %}{% dynamic print setvar.api_names %}{% dynamic else %}{% dynamic endif %}{% dynamic if "," in setvar.api_list %} API{% dynamic elif "API" in setvar.api_names %}{% dynamic else %} API{% dynamic endif %} necesarias. {% dynamic endif %}

    Habilita las {% dynamic if "," in setvar.api_list %} API{% dynamic else %} API{% dynamic endif %}

    {% dynamic endif %}{% dynamic endif %}{% dynamic if "no_steps" not in setvar.task_params %}
  6. {% dynamic endif %}{% dynamic endsetvar %}{% dynamic print setvar.console %}

Limitaciones

La versión Beta de la IU web de BigQuery está sujeta a las limitaciones siguientes. Los clientes interesados en realizar tareas en la IU web de BigQuery que no son compatibles por el momento deben considerar el uso de la IU web clásica en su lugar.

Por el momento, no puedes usar la IU web de BigQuery para realizar las acciones siguientes:

  • Trabajar con el Servicio de transferencia de datos de BigQuery
  • Asignar controles de acceso a los conjuntos de datos
  • Ver el cronograma de ejecución de la consulta
  • Navegar desde la primera hasta la última página de los resultados de la consulta
  • Mostrar la advertencia de precios cuando ejecutas una consulta de SQL SELECT *

También ten en cuenta que los conjuntos de datos públicos de BigQuery no se muestran de forma predeterminada en la IU web de BigQuery. Para fijar los conjuntos de datos públicos, haz clic en el menú desplegable "Agregar datos" y, luego, selecciona "Explorar conjuntos de datos públicos".

Abre la IU web de BigQuery

Para abrir la IU web de BigQuery, haz lo siguiente:

  1. Abre Cloud Console.

    Ir a Cloud Console

  2. En el panel de navegación, haz clic en BigQuery.

También puedes abrir la IU web de BigQuery de forma directa si ingresas la siguiente URL en tu navegador:

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

Si haces clic en el botón a continuación, se abrirá la IU web de BigQuery de forma directa con el último proyecto al que accediste.

Ir a la IU web de BigQuery

Cambia a la IU web clásica

Puedes cambiar a la IU web clásica, si lo prefieres, con el ícono de información que se encuentra a la derecha de la barra de título. Para cambiar a la IU web clásica, haz clic en el botón que se encuentra a la derecha del banner Beta.

Vínculo a la IU web clásica

Descripción general de la tabla de la IU web de BigQuery

La IU web de BigQuery tiene tres secciones principales:

  1. El lado izquierdo de la página (el panel de navegación):

    El panel de navegación contiene una lista de recursos de BigQuery que puedes ver.

    • En la sección Query history (Historial de consultas), se muestran los trabajos de consulta de tu proyecto.
    • En la sección Saved queries (Consultas guardadas), se muestran tus consultas guardadas y compartidas.
    • En la sección Job history (Historial de trabajos), se muestran los trabajos de carga, exportación y copia de tu proyecto.
    • En la sección Transfers (Transferencias), se abre la IU del Servicio de transferencia de datos de BigQuery.
    • En la sección Resources (Recursos), se muestra una lista de proyectos fijados. Expande un proyecto para ver los conjuntos de datos y tablas a las que tienes acceso.
    • Hay un cuadro de búsqueda disponible en la sección Recursos que te permite buscar recursos por nombre (nombre del proyecto, nombre del conjunto de datos, nombre de la tabla o nombre de la vista) o por etiqueta. En la barra de búsqueda, puedes encontrar todos los recursos que coinciden o que contienen coincidencias dentro de tus proyectos actuales y fijados.
  2. El panel de detalles:
    Contiene información adecuada para la acción seleccionada en el panel de navegación. Por ejemplo, si haces clic en un conjunto de datos en el panel de navegación, el panel de detalles muestra información sobre el conjunto de datos.
  3. El editor de consultas:
    Si haces clic en Compose new query (Redactar consulta nueva), el editor de consultas aparece sobre el panel de detalles. Haz clic en Hide Editor (Ocultar editor) para ocultar el editor cuando ya no lo necesites.

Captura de pantalla de la IU web de BigQuery

Muestra los recursos

El panel de navegación enumera los conjuntos de datos que puedes explorar en el proyecto actual. Haz clic en el ícono expandir ícono de conjunto de datos que está al lado de tu proyecto para mostrar los conjuntos de datos en ese proyecto. Haz clic en el ícono que se encuentra junto a un conjunto de datos para expandirlo y mostrar las tablas dentro de ese conjunto de datos.

Si haces clic en un conjunto de datos o una tabla se mostrará información sobre el recurso del panel de detalles. Cuando haces clic en una tabla en el panel de navegación, puedes hacer clic en el botón Query Table (Tabla de consultas) que se encuentra en el lado derecho del panel de detalles a fin de propagar una consulta básica para esa tabla en el cuadro de consulta. Puedes modificar la consulta a mano si quieres especificar campos o personalizar la consulta. No estás limitado a realizar consultas en la tabla ya seleccionada. Para obtener más información sobre las consultas de tablas, visita Ejecuta consultas interactivas.

Trabaja con proyectos

Todo tu trabajo de BigQuery se realiza dentro de un proyecto. El nombre de este proyecto se puede ver en el panel de navegación que se encuentra debajo del cuadro de filtros de conjuntos de datos. También puedes ver el proyecto actual con la barra de la plataforma que se encuentra en la parte superior de la página.

Barra de plataforma

Todo tu trabajo dentro del proyecto se cobra a la cuenta de facturación adjunta al proyecto. Para obtener más información sobre los cobros de BigQuery, consulta la página de precios.

En la IU web, puedes llevar a cabo estas acciones:

  • Cambiar a un proyecto diferente
  • Agregar (o fijar) proyectos adicionales
  • Quitar proyectos fijados

Cambia el proyecto

Para cambiar proyectos en la IU web de BigQuery, sigue estos pasos:

  1. En la barra de la plataforma que se encuentra en la parte superior de la página, haz clic en tu proyecto.

    Barra de plataforma

  2. En el cuadro de diálogo de proyectos, haz clic en el nombre del proyecto en la lista. Esto reemplaza tu proyecto anterior en la IU con el que elegiste.

Fija (agrega) un proyecto

Puedes agregar o “fijar” un proyecto en la IU web con la opción de fijar proyecto.

Puedes fijar un proyecto de una de las maneras siguientes:

  • Cambia al proyecto y, luego, fíjalo.
  • Usa la opción Pin Project (Fijar proyecto) en el panel de navegación.

Opción 1: abrir un proyecto y, luego, fijarlo

Para fijar un proyecto después de abrirlo, sigue estos pasos:

  1. Cambia al proyecto que quieres fijar al panel de navegación.

  2. En el panel de navegación, haz clic en el ID del proyecto.

  3. En el panel de detalles, en el lado derecho, haz clic en Fijar proyecto.

    Fija el proyecto

Opción 2: usar la opción Fijar proyecto

Para fijar un proyecto con el cuadro de diálogo Fijar proyecto, sigue estos pasos:

  1. En el panel de navegación, en la sección Recursos, haz clic en Fijar proyecto.

  2. En el cuadro de diálogo Fijar proyecto, haz clic en la lista desplegable Select a project (Seleccionar un proyecto). Puedes elegir un proyecto de la lista Recently selected projects (Últimos proyectos seleccionados) o puedes usar el cuadro "Filtrar por…" para buscar con rapidez en la lista All projects (Todos los proyectos).

  3. Después de elegir el proyecto, haz clic en Fijar proyecto para cerrar el cuadro de diálogo Fijar proyecto.

Quita un proyecto de la IU

Para quitar un proyecto que ya agregaste (o “fijaste”), sigue estos pasos:

  1. Haz clic en el ID del proyecto en el panel de navegación.

  2. En el panel de detalles, en el lado derecho, haz clic en Unpin Project (No fijar proyecto).

Visualiza el historial de trabajos y consultas

A medida que ejecutas trabajos y consultas con la IU web de BigQuery, tu historial se conserva en el panel de navegación. Las consultas también son un tipo de trabajo, pero tu historial de consultas se conserva por separado para facilitar su uso.

El historial de trabajos y consultas en la IU incluye todos los trabajos de carga, exportación, copia y consulta que enviaste en los últimos 6 meses (hasta 1,000 entradas). El límite de 1,000 trabajos es acumulativo en todos los tipos de trabajos.

Para hacer una lista de todos los trabajos disponibles en el historial, usa el método de la API jobs.list o el comando de CLI bq ls.

Visualiza el historial de trabajos

Para ver tu historial de trabajos, haz clic en el vínculo Job History (Historial de trabajo) en el panel de navegación.

En el panel de detalles del historial de trabajos, haz clic en un trabajo específico para ver los detalles o repetir el trabajo. Puedes repetir un trabajo de carga con la IU web, pero no puedes repetir un trabajo de exportación o de copia.

Visualiza el historial de consultas

Para ver tu historial de consultas, haz clic en el vínculo Query History (Historial de consultas) en el panel de navegación.

En el panel de detalles del historial de consultas, haz clic en un trabajo de consulta específico para ver los detalles o abrir la consulta en el editor de consultas. Cuando abres la consulta en el editor de consultas, puedes repetir la consulta con un clic en Run Query (Ejecutar consulta).

Límites de visualización de la IU web

La IU web de BigQuery tiene los límites de visualización siguientes:

  • Solo se pueden mostrar 1,000 conjuntos de datos en el panel de navegación.
  • En el panel de navegación se muestran hasta 50,000 tablas por conjunto de datos. Puedes mostrar un total acumulado de 1,000,000 de tablas entre todos los conjuntos de datos (incluidos los conjuntos de datos en proyectos fijados).

Combinaciones de teclas

Las siguientes combinaciones de teclas se admiten en la IU web de BigQuery:

Combinación de teclas (Windows y Linux) Combinación de teclas (macOS) Acción
Ctrl + Espacio Ctrl + Espacio Si no hay una consulta abierta, redacta una consulta nueva.
Si el editor de consultas está abierto, completa de forma automática la palabra actual.
Ctrl + Intro Cmd + Intro Ejecuta una consulta actual.
Tab Tab Completa de forma automática la palabra actual.
Ctrl Cmd Resalta los nombres de tablas.
Ctrl + clic en el nombre de la tabla Cmd + clic en el nombre de la tabla Abre el esquema de tabla.
Ctrl + E Cmd + E Ejecuta una consulta desde la selección.
Ctrl + / Cmd + / Comenta líneas actuales o seleccionadas.
Ctrl + Mayús + F Cmd + Mayús + F Cambia el formato de la consulta.

Ejemplos

Cuando la IU web de BigQuery esté disponible para el público general, encontrarás ejemplos de la IU web en la sección Guías prácticas de la documentación de BigQuery.

Para ver ejemplos actuales de carga y consulta de datos con la IU web de BigQuery, consulta la Guía de inicio rápido con la IU web de BigQuery.

¿Te ha resultado útil esta página? Enviar comentarios:

Enviar comentarios sobre...

Si necesitas ayuda, visita nuestra página de asistencia.