Usa la IU web clásica de BigQuery

BigQuery expone dos IU web gráficas que puedes usar para crear y administrar recursos de BigQuery, además de ejecutar consultas de SQL: la IU web de BigQuery y la IU clásica. En esta página, se presenta la IU web clásica.

En este documento, se proporcionan detalles sobre la IU web clásica de BigQuery. La opción preferida es la IU web de BigQuery en Cloud Console.

Para obtener una introducción sobre el uso de las IU web, consulta una de las siguientes opciones:

Antes de comenzar

Antes de que puedas usar la IU web clásica de BigQuery, debes crear o seleccionar un proyecto y habilitar la facturación con Cloud Console.

  1. Accede a tu Cuenta de Google.

    Si todavía no tienes una cuenta, regístrate para obtener una nueva.

  2. Selecciona o crea un proyecto de GCP.

    Ir a la página Administrar recursos

  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, ve a Habilita las BigQuery API necesarias.

    Habilita las API

Abre la IU web clásica

Para abrir la IU web clásica, ingresa la siguiente URL en tu navegador y reemplaza project_id por el ID del proyecto que abres en la IU web clásica:

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

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

Ir a la IU web clásica.

Descripción general de la IU web clásica

La IU web clásica tiene tres secciones principales:

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

    La mitad superior del panel de navegación contiene una lista de elementos que describen las acciones que puedes realizar: redactar una consulta, ver el historial de consultas o ver el historial de trabajos.

    La mitad inferior del panel de navegación contiene una lista de los conjuntos de datos del proyecto actual a los que tienes acceso, además de los conjuntos de datos públicos de BigQuery. Hay un cuadro de filtro disponible que te permite filtrar por ID de conjunto de datos o etiqueta.

  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. La ventana de consultas:
    Cuando haces clic en Compose Query (Redactar consulta), se agrega una ventana de New Query (Nueva consulta) sobre el panel de detalles. Esta ventana se puede cerrar cuando ya no la necesites.

captura de pantalla de la IU web de BigQuery

Muestra los recursos

El panel de navegación hace una lista de los conjuntos de datos que puedes explorar en el proyecto actual. Haz clic en el ícono expandir ícono de conjunto de datos junto a un conjunto de datos o haz clic en el nombre del conjunto de datos para expandirlo y mostrar las tablas dentro de ese conjunto de datos.

Si haces clic en una tabla se mostrará información sobre ella en el panel de detalles. Luego, puedes hacer clic en el botón Query Table (Tabla de consultas) que se encuentra en el lado derecho del panel a fin de rellenar el cuadro de consulta con una consulta básica para esa tabla. 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.

Agrega y quita 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 sobre la lista de conjuntos de datos. 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 clásica, puedes realizar las siguientes acciones:

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

Agrega un proyecto

Puedes agregar o “fijar” un proyecto en la IU web clásica mediante el menú desplegable del proyecto.

Para agregar un proyecto a la IU clásica, sigue estos pasos:

  1. Haz clic en el ícono de flecha hacia abajo ícono de flecha hacia abajo junto al nombre de tu proyecto en el panel de navegación.

  2. En el menú desplegable, haz clic en Cambiar a proyecto > Mostrar proyecto.

  3. En el cuadro de diálogo Display Project (Mostrar proyecto), haz lo siguiente:

    • Ingresa el ID del proyecto.
    • Mantén seleccionada la opción Display project in navigation panel (Mostrar proyecto en el panel de navegación).
    • Haz clic en OK (Aceptar) para agregar el proyecto al panel de navegación.

      mostrar el cuadro de diálogo del proyecto

Quita un proyecto de la IU clásica

Para quitar un proyecto que ya agregaste (o “fijaste”), haz lo siguiente:

  1. Haz clic en el ícono de flecha hacia abajo ícono de flecha hacia abajo junto al nombre de proyecto en el panel de navegación.

  2. En el menú desplegable, haz clic en Quitar proyecto del panel.

Cambia el proyecto

Si prefieres cambiar a otro proyecto (en lugar de fijarlo en la IU), puedes usar el menú contextual.

Para cambiar proyectos, haz lo siguiente:

  1. Haz clic en el ícono de flecha hacia abajo ícono de flecha hacia abajo junto al nombre de tu proyecto en el panel de navegación.

  2. En el menú desplegable, haz clic en Cambiar a proyecto y elige el proyecto de la lista. Esto reemplaza tu proyecto anterior en la IU con el que elegiste.

Agrega un conjunto de datos compartido

Es posible que otro usuario comparta un conjunto de datos sin darte acceso al proyecto correspondiente. Si eso sucede, deberías recibir un correo electrónico con el nombre del proyecto que contiene el conjunto de datos compartido. El proyecto y el conjunto de datos no aparecen en la IU clásica de manera automática.

Si haces clic en el vínculo browser tool en el correo electrónico, se abrirá la IU web con el proyecto mostrado. Si prefieres fijar el proyecto que contiene el conjunto de datos compartido, sigue los pasos en Agrega un proyecto.

Visualiza el historial de trabajos y consultas

A medida que ejecutes trabajos y ejecutes consultas con la IU web clásica, 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.

Visualiza el historial de trabajos

Para ver tu historial de trabajos, puedes realizar una de las siguientes acciones:

  • Hacer clic en el vínculo Historial de trabajos en el panel de navegación.

  • Ingresar la siguiente URL en tu navegador:

    https://bigquery.cloud.google.com/jobs/project_id

Puedes repetir un trabajo de carga con la IU web, pero no puedes repetir un trabajo de exportación o copia.

Visualiza el historial de consultas

Para ver el historial de consultas, puedes realizar una de las siguientes acciones:

  • Hacer clic en el vínculo Historial de consultas en el panel de navegación.

  • Ingresar la siguiente URL en tu navegador:

    https://bigquery.cloud.google.com/queries/project_id

Puedes repetir un trabajo de consulta con la IU web.

Busca en el historial de trabajos y consultas

Puedes filtrar (o buscar) tu historial de trabajos o consultas para mostrar solo trabajos particulares que cumplan con tus criterios. Los resultados mostrados se limitan al grupo de trabajos que recupera la IU clásica. De forma predeterminada, la IU clásica te permite buscar los 1,000 trabajos más recientes.

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.

Para filtrar tu historial de trabajos o consultas, haz lo siguiente:

  1. En el panel de navegación, haz clic en Historial de trabajos o Historial de consultas.
  2. Haz clic en el menú desplegable “filtrar trabajos” para abrir el cuadro de expresión de filtro.
  3. En el cuadro de expresión de filtro, haz lo siguiente:

    • Haz clic en Cualquiera para elegir un criterio de filtro.
    • Haz clic en el menú desplegable de operadores y elige uno. Según los criterios que elijas, la lista de operadores cambia. Por ejemplo, si eliges un criterio de texto, la lista de operadores incluirá substring y regex.
    • Ingresa un valor en el cuadro.

      Generador de expresiones de filtro

  4. Haz clic en And (Y) para agregar un criterio adicional opcional al filtro.

  5. Haz clic en Search (Buscar).

Puedes filtrar trabajos de consultas con las siguientes propiedades de trabajo:

  • Any: cualquier propiedad
  • Job ID (jobid) (ID del trabajo): el ID de trabajo único y opaco
  • User (user) (Usuario): el usuario que envió el trabajo
  • Start Time (start) (Hora de inicio): hora de inicio del trabajo en milésimas de segundo desde el ciclo de entrenamiento Esta propiedad está presente cuando el trabajo pasa del estado PENDING a RUNNING o DONE
  • End Time (end) (Hora de finalización): hora de finalización del trabajo en milésimas de segundo desde el ciclo de entrenamiento Esta propiedad está presente cuando un trabajo tiene el estado DONE
  • Destination Table (dest) (Tabla de destino): el nombre de la tabla de destino para la operación de trabajo (carga, copia o consulta)
  • Query Text (Texto de consulta): el texto de la consulta de SQL enviada
  • Bytes processed (Bytes procesados): la cantidad total de bytes que procesa la consulta de SQL
  • UDF code (Código de UDF): un recurso intercalado que contiene código para una función definida por el usuario (UDF)

Puedes filtrar trabajos de carga, copia y extracción con las siguientes propiedades de trabajo:

  • Any: cualquier propiedad
  • Job ID (jobid): el ID de trabajo único y opaco
  • User (user): el usuario que envió el trabajo
  • Start Time (start): hora de inicio del trabajo en milésimas de segundo desde el ciclo de entrenamiento Esta propiedad está presente cuando el trabajo pasa del estado PENDING a RUNNING o DONE
  • End Time (end): hora de finalización del trabajo en milésimas de segundo desde el ciclo de entrenamiento Esta propiedad está presente cuando un trabajo tiene el estado DONE
  • Destination Table (dest): el nombre de la tabla de destino para la operación de trabajo (carga, copia o consulta)
  • Title (title) (Título): el título como se muestra en el historial, por ejemplo, el título de un trabajo de carga podría ser: “archivo subido a myproject:mydataset.mytable”
  • Type (type) (Tipo): el tipo de trabajo, ya sea de carga, consulta, copia o extracción (exportación)
  • Copy Source (copysrc) (Origen de la copia): la tabla de origen en un trabajo de copia
  • Destination URI (desturi) (URI de destino): el URI de destino de Cloud Storage para un trabajo de extracción (exportación)
  • Source Table (srctable) (Tabla de origen): la tabla de origen en un trabajo de extracción
  • Source URI (srcuri) (URI de origen): el URI de origen de Cloud Storage para un trabajo de carga

Ordena el historial de consultas

También puedes ordenar el historial de consultas en la IU clásica con la opción Sort by (Ordenar por) en el panel Queries (Consultas). El panel Queries se abre si haces clic en Query History (Historial de consultas) en el panel de navegación.

Botón Sort By del historial de consultas

Las opciones de ordenamiento incluyen lo siguiente:

  • Date (Fecha): ordena las consultas por fecha de ejecución.
  • Duration (Duración): ordena las consultas por tiempo total de ejecución.
  • Duration/byte (Duración/byte): ordena las consultas por duración, normalizadas por bytes de entrada. Esto te permite comparar el tiempo de ejecución de las consultas con diferentes tamaños de entrada. Por ejemplo, puede que tengas un conjunto de tablas que crezca con el tiempo y quieras comparar la eficiencia de tus consultas y descontar la diferencia que se debe solo al cambio en el tamaño de la entrada. Esto supone que la relación entre el tamaño de entrada y el entorno de ejecución es lineal.
  • Input bytes (Bytes de entrada): ordena las consultas por bytes leídos.
  • Slot-ms (Ranura-milésimas de segundo): ordena las consultas por la suma de milésimas de segundo activos en todas las ranuras que usa la consulta. El ordenamiento por slot-ms es una medida más estable del esfuerzo de procesamiento porque se ve menos afectada por las demoras del sistema y por otras fuentes de incertidumbre que pueden afectar la duración observada.
  • Slot-ms/byte (Ranura-milésimas de segundo/byte): similar a Duration/byte. Slot-ms/byte es una forma normalizada de Slot-ms.

    Opciones de ordenamiento del historial de consultas

Límites de visualización de la IU web

La IU web clásica tiene los siguientes límites de visualización:

  • Solo se pueden mostrar 1,000 conjuntos de datos en el panel de navegación.
  • En el panel de navegación se muestran hasta 30,000 tablas por proyecto.

Controla el rendimiento de visualización de la IU web

En raras ocasiones, el rendimiento de la IU web clásica puede verse afectado cuando un proyecto tiene una gran cantidad de conjuntos de datos que contienen una gran cantidad de tablas. Para mejorar el rendimiento de la IU cuando tu proyecto contiene una gran cantidad de recursos, usa el parámetro ?minimal a fin de limitar el número de recursos mostrados a 10,000 tablas por proyecto. Por ejemplo, ingresa la siguiente URL en tu navegador para limitar la cantidad de recursos que se muestran:

https://bigquery.cloud.google.com/queries/project_id?minimal.

Combinaciones de teclas

Las siguientes combinaciones de teclas se admiten en la IU web clásica:

Combinación de teclas (Windows y Linux) Combinación de teclas (macOS) Acción
Ctrl + Espacio Ctrl + Espacio Si no hay una consulta abierta, redactar consulta nueva
Si el editor de consultas está abierto, autocompletar la palabra actual
Ctrl + Intro Cmd + Intro Ejecutar consulta actual
Tabulador Tabulador Autocompletar palabra actual
Ctrl Cmd Resaltar nombres de tablas
Ctrl + clic en el nombre de la tabla Cmd + clic en el nombre de la tabla Abrir esquema de tabla
Ctrl + E Cmd + E Ejecutar consulta desde la selección
Ctrl + / Cmd + / Comentar líneas actuales o seleccionadas
Ctrl + Mayús + F Cmd + Mayús + F Cambiar el formato de la consulta

Ejemplos

Puedes encontrar ejemplos de la IU web clásica en la sección Guía práctica de la documentación de BigQuery. A continuación, se encuentran vínculos a tareas comunes de la IU web, como ejecutar consultas y crear, obtener, enumerar, borrar y modificar recursos de BigQuery.

Consulta datos

Si quieres obtener más información sobre el uso de la IU web clásica para crear y ejecutar consultas, lee los siguientes artículos:

Crea recursos

Si quieres obtener más información sobre el uso de la IU web clásica para crear recursos, consulta lo siguiente:

Obtén información sobre los recursos

Si quieres interiorizarte sobre el uso de la IU web clásica para obtener información sobre los recursos, consulta estos artículos:

Haz una lista de recursos

Si quieres obtener más información sobre el uso de la IU web clásica para enumerar recursos, consulta los siguientes vínculos:

Actualiza recursos

Si quieres obtener más información sobre el uso de la IU web clásica para actualizar recursos, consulta estos artículos:

Carga datos

Si quieres obtener más información sobre el uso de la IU web clásica para cargar datos, consulta lo siguiente:

Usa fuentes de datos externas

Si quieres obtener más información sobre el uso de la IU web clásica para consultar datos en fuentes de datos externas, consulta estos artículos:

Exporta datos

Si quieres obtener más información sobre el uso de la IU web clásica para exportar datos, consulta el siguiente vínculo:

Usa el servicio de transferencia de datos de BigQuery

A fin de obtener información sobre el uso de la IU web clásica con el servicio de transferencia de datos de BigQuery, consulta los siguientes vínculos:

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

Enviar comentarios sobre...

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