Usa la IU web clásica de BigQuery

Prueba la nueva IU web de BigQuery y envíanos tus comentarios. Obtén más información sobre cómo migrar a Google Cloud Console.

Descripción general

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 en Cloud Console y la IU web clásica de BigQuery. En esta página, se presenta la IU web clásica.

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

Antes de comenzar

Antes de poder usar la IU web clásica de BigQuery, debes crear o seleccionar un proyecto 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. BigQuery se habilita de manera automática en proyectos nuevos. Para activar BigQuery en un proyecto preexistente, dirígete a Habilita las BigQuery API necesarias.

    Habilita las API

  4. BigQuery proporciona una zona de pruebas si no deseas proporcionar una tarjeta de crédito o habilitar la facturación del proyecto. Los pasos de este tema funcionan para un proyecto, más allá de si el proyecto tiene o no habilitada la facturación. Si prefieres habilitar la facturación, consulta la página Modifica la configuración de facturación de un proyecto.

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/queries/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, en el panel de detalles se mostrará información sobre el conjunto de datos.
  3. La ventana de consultas:
    Cuando haces clic en Redactar consulta (Compose Query), se agrega una ventana llamada Consulta nueva (New Query) 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 ícono de expandir el conjunto de datos junto a un conjunto de datos o en el nombre del conjunto de datos para expandirlo y mostrar las tablas que contiene.

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 Consultar Tabla que se encuentra en el lado derecho del panel a fin de propagar 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 Cómo ejecutar trabajos de consulta interactivos y por lotes.

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 Mostrar proyecto (Display Project), sigue estos pasos:

    • 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 Aceptar(OK) para agregar el proyecto al panel de navegación.

      cuadro de diálogo mostrar 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 el proyecto y elige el proyecto de la lista. Esto reemplaza tu proyecto anterior en la IU por 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 y se mostrará el proyecto. 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 ejecutas trabajos y 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 que se muestran 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 enumerar todos los trabajos disponibles en el historial, usa el método jobs.list de la API o el comando bq ls de la CLI.

Para filtrar tu historial de trabajos o consultas, sigue estos pasos:

  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 Any (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 consulta 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 milisegundos desde la época. 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 milisegundos desde la época. 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)
  • Query Text: el texto de la consulta de SQL enviada
  • Bytes processed: la cantidad total de bytes que procesa la consulta de SQL
  • UDF code: 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 milisegundos desde la época. 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 milisegundos desde la época. 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): 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): 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 Consultas (Queries) se abre si haces clic en Historial de consultas (Query History) en el panel de navegación.

Botón Sort By del historial de consultas

Las opciones de ordenamiento incluyen lo siguiente:

  • Date: ordena las consultas por fecha de ejecución.
  • Duration (Duración): ordena las consultas por tiempo total de ejecución.
  • Duration/byte (Duración por 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, podrías tener un conjunto de tablas que crece con el tiempo y querer comparar la eficiencia de tus consultas, a la vez que se descuenta la diferencia debida solo al cambio en el tamaño de la entrada. Así se 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: ordena las consultas por la suma de los milisegundos 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 otras fuentes de incertidumbre que pueden afectar la duración observada.
  • Slot-ms/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 clásica

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 la visualización de la IU clásica

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 la cantidad de recursos que se muestran a 10,000 tablas por proyecto. Por ejemplo, puedes ingresar la URL siguiente 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 ninguna consulta abierta, redactar una 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ías prácticas de la documentación de BigQuery. A continuación, se proporcionan 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:

Cambia a Google Cloud Console

La IU web de BigQuery en Google Cloud Console alcanzó disponibilidad general (GA) en abril de 2019. Cloud Console proporciona coherencia con el resto de Google Cloud y permite lanzar actualizaciones más rápidas de características nuevas. Además, Cloud Console tiene elementos de IU fáciles de usar, como los controles para ordenar y filtrar tu historial de consultas, además de compartir conjuntos de datos.

Ahora que la IU web de BigQuery en Google Cloud Platform Console alcanzó la disponibilidad general, la IU web clásica de BigQuery ya no recibe asistencia ni actualizaciones de características, excepto correcciones de seguridad críticas.

El cronograma de migración para la IU web clásica de BigQuery es el siguiente:

  • Diciembre de 2019:
    Si intentas acceder a la IU web clásica, se te redireccionará a Cloud Console. Los usuarios redireccionados podrán rechazar las redirecciones futuras.
  • Junio de 2020:
    A partir de junio de 2020, solo podrás usar la IU web de BigQuery en Google Cloud Platform Console.

La mayoría de las funciones de la IU web clásica ya son compatibles con Google Cloud Platform Console. A continuación, se presenta un resumen de las principales diferencias entre la IU web clásica y GCP Console:

IU web clásica Google Cloud Console
La sintaxis de consulta predeterminada es SQL heredado. Para habilitar SQL estándar, debes usar un prefijo de consulta de SQL estándar. Las consultas se ejecutan en SQL estándar de forma predeterminada, pero puedes volver a SQL heredado con la opción del menú Configuración de consulta. Las funciones definidas por el usuario deben escribirse en SQL estándar.
Admite el uso de Bigtable como fuente de datos externa. Podrás consultar las tablas de Bigtable en Cloud Console al menos tres meses antes de que se retire de servicio la IU web clásica.
Admite la actualización de la lista de recursos en un proyecto. Podrás actualizar la lista de recursos en un proyecto al menos tres meses antes de que se retire de servicio la IU web clásica.
¿Te ha resultado útil esta página? Enviar comentarios:

Enviar comentarios sobre...

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