Compila consultas en la consola

Puedes consultar y ver tus datos de Bigtable con el compilador de consultas de Bigtable Studio. El Creador de consultas es un formulario interactivo en la consola de Google Cloud que te permite crear una consulta, ejecutarla en una tabla y, luego, ver los resultados en la consola.

El compilador de consultas de Bigtable Studio te permite usar selectores desplegables para especificar una combinación de cláusulas de consulta sin necesidad de escribir una aplicación ni usar una CLI. Cuando ejecutas la consulta, la consola realiza una llamada a la API de Bigtable Data, que muestra los datos que coinciden con tu consulta.

En este documento, se describe cómo usar el compilador de consultas y se ofrecen sugerencias para optimizar tus consultas. Antes de leer esta página, debes familiarizarte con la descripción general de Bigtable.

Las consultas que se ejecutan en el compilador de consultas están sujetas a los mismos precios y cuotas que cualquier otra consulta que se envíe a una tabla.

Cuándo usar el compilador de consultas

La capacidad de consultar tus datos de Bigtable en la consola de Google Cloud es útil cuando necesitas hacer lo siguiente:

  • Obtén rápidamente una representación visual del esquema de tu tabla.
  • Verifica que ciertos datos se hayan escrito correctamente.
  • Validar la integridad de los datos durante una migración
  • Depurar posibles problemas de datos
  • Obtén una vista previa de los resultados que muestra una combinación específica de cláusulas antes de usarlos en tu código. Esto puede ser especialmente útil para los usuarios nuevos de Bigtable, así como para los usuarios experimentados que no quieren usar la CLI de cbt.

Antes de comenzar

Para obtener los permisos que necesitas para usar el compilador de consultas, pídele a tu administrador que te otorgue el rol de IAM Lector de Bigtable (roles/bigtable.reader) en el proyecto. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

Este rol predefinido contiene los permisos necesarios para usar el Creador de consultas. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:

Permisos necesarios

Se requieren los siguientes permisos para usar el compilador de consultas:

  • bigtable.tables.get
  • bigtable.instances.get
  • bigtable.appProfiles.list
  • bigtable.tables.list
  • bigtable.tables.readRows

También puedes obtener estos permisos con roles personalizados o con otros roles predefinidos.

Si no tienes una tabla para consultar, puedes crear una pequeña tabla de prueba y ejecutar tus consultas en ella.

Abre el compilador de consultas

Cuando abres el compilador de consultas, se ejecuta y muestra una consulta predeterminada para la primera tabla en orden alfabético en la instancia. La consulta predeterminada se ejecuta con el perfil de app predeterminado y se muestran hasta 100 filas.

  1. Abre la lista de instancias de Bigtable en la consola de Google Cloud.

    Abrir la lista de instancias

  2. Haz clic en el nombre de la instancia que contiene la tabla que deseas consultar.

  3. En el panel de navegación, haz clic en Bigtable Studio. Se abrirá la página Bigtable Studio en el modo del compilador de consultas. El panel Explorador proporciona una lista de las tablas de la instancia, y el panel Resultados de la consulta muestra los resultados de la consulta predeterminada.

  4. Opcional: Contrae el panel Explorador para agrandar el panel del compilador de consultas.

Formato de visualización de datos

Los resultados del compilador de consultas se muestran en una tabla. El primer encabezado y la primera columna son Clave de fila. Los encabezados restantes representan cada una una columna en la tabla de Bigtable, expresada como la familia de columnas y el calificador de columnas separados por dos puntos. Por ejemplo, el encabezado cell_plan: data_plan_01gb indica que los valores de esa columna provienen de la columna data_plan_01gb en la familia de columnas cell_plan.

desplegable

Solo se muestra el valor más reciente de una columna. Las marcas de tiempo están ocultas de forma predeterminada, pero puedes hacer clic en el botón de activación para mostrarlas.

Seleccionar una tabla

Usa el menú desplegable Tabla para seleccionar el ID de la tabla que deseas consultar.

Opcional: Especifica un perfil de app

Puedes usar un perfil de app que crees específicamente para usarlo con el compilador de consultas. Esto puede ser útil, por ejemplo, cuando deseas aislar el tráfico de consultas usando un clúster diferente al que usa tu aplicación principal.

Para usar un perfil de app diferente para ejecutar tu próxima consulta, sigue estos pasos.

  1. Haz clic en Agregar a la consulta.
  2. Haz clic en Cambiar el perfil de la app (predeterminado). Aparecerá un nuevo menú desplegable.
  3. Usa el menú desplegable Perfil de app y elige de la lista de perfiles de app de la instancia.

Para obtener más información sobre las ventajas de usar diferentes perfiles de app para diferentes cargas de trabajo, consulta Acerca de los perfiles de app. Para obtener información sobre cómo crear un perfil de app, consulta Crea y configura perfiles de app.

Si tu tabla se encuentra en una instancia que usa la replicación, configura el perfil de tu app para que lea desde el clúster que esté más cerca de ti geográficamente.

Agrega cláusulas a la consulta y, luego, ejecútala

  1. Después de seleccionar la tabla y el perfil de la app, agrega cláusulas a la consulta. Consulta la siguiente sección para obtener detalles sobre las cláusulas disponibles.
  2. Después de agregar todas las cláusulas, haz clic en Run.
  3. Observa los resultados.

Cláusulas de consulta

Usas el compilador de consultas para agregar cláusulas a tu consulta. Cuando ejecutas la consulta, el compilador de consultas crea y envía una solicitud de lectura a tu tabla. Para obtener más información sobre las solicitudes de lectura, consulta Lecturas.

Las cláusulas de clave de fila, rango de clave de fila y prefijo de clave de fila determinan las filas que se recuperan del almacenamiento. La regex de la clave de fila, las columnas y las cláusulas de período agregan un filtro a la solicitud de lectura generada. Los filtros que usas en el compilador de consultas funcionan de la misma manera que cuando los usas en las bibliotecas cliente. Para obtener detalles sobre los filtros de Bigtable y cómo su uso puede afectar el rendimiento, consulta Filtros y Cómo usar filtros.

Especifica la clave de fila

Para recuperar una sola fila de la tabla, proporciona un valor de clave de fila. Puedes agregar varias cláusulas de clave de fila.

  1. Haz clic en Agregar a la consulta.
  2. En la lista desplegable, selecciona Clave de fila.
  3. Ingresa el valor exacto de la clave de fila para la que deseas ver los valores.

Especifica un rango de clave de fila

Para recuperar un rango de filas de la tabla, especifica una clave de fila inicial y final. Bigtable almacena los datos en orden lexicográfico por clave de fila.

  1. Haz clic en Agregar a la consulta.
  2. En la lista desplegable, selecciona Rango de claves de fila.
  3. Ingresa la clave de fila de inicio completa.
  4. Ingresa la clave de fila de finalización completa.

Especifica un prefijo de clave de fila

Para recuperar solo las filas cuyas claves de fila comienzan con un conjunto específico de caracteres, filtra por prefijo de clave de fila. Un prefijo de clave de fila es los primeros N caracteres de una clave de fila. Por convención, a menudo hay un hashtag, una barra o algún otro símbolo entre el prefijo y el resto de la clave de fila.

  1. Haz clic en Agregar a la consulta.
  2. En la lista desplegable, selecciona Prefijo de clave de fila.
  3. Ingresa un prefijo de clave de fila. No es necesario que ingreses ningún símbolo comodín.

Cómo filtrar por regex de la clave de fila

Para obtener solo las filas cuyos valores de clave de fila coinciden con una expresión regular especificada, usa un filtro de regex de clave de fila. Para mejorar el rendimiento, agrega un rango de clave de fila o una cláusula de prefijo de clave de fila a la consulta antes de agregar el filtro de regex de clave de fila. Para obtener orientación sobre cómo redactar tu regex, consulta Regex de la clave de fila.

  1. Haz clic en Agregar a la consulta.
  2. En la lista desplegable, selecciona Regex de clave de fila.
  3. Ingresa una expresión regular que use la sintaxis de re2.

Filtrar por columna

Para especificar una o más columnas que se incluirán en la consulta, agrega una cláusula columns y elige la familia de columnas y el calificador de columna para cada columna por la que deseas filtrar. La solicitud de lectura que se genera cuando agregas esta cláusula incluye el filtro de regex de familia de columnas y el filtro de rango de columnas .

  1. Haz clic en Agregar a la consulta.
  2. En la lista desplegable, selecciona Columnas.
  3. Haz clic en el campo Columnas. Se mostrará una lista de familias de columnas.
  4. Haz clic en el ID de una familia de columnas. Se mostrará una lista de calificadores de columna.
  5. Haz clic en un calificador de columna.

Filtrar por intervalo de tiempo

Para recuperar solo las celdas con una marca de tiempo dentro de un rango determinado, agrega una cláusula de rango de tiempo, que usa el filtro de rango de marca de tiempo.

  1. Haz clic en Agregar a la consulta.
  2. En la lista desplegable, selecciona Rango de tiempo.
  3. Ingresa una marca de tiempo de inicio.
  4. Ingresa una marca de tiempo de finalización.

Proporciona una marca de tiempo en uno de los siguientes formatos:

  • Una marca de tiempo de Unix en microsegundos, como 3023483279876000
  • YYYY-MM-DDThh:mm:ss:ss[z]
  • YYYY/MM/DD-hh:mm:ss.sss[z]
  • MM/DD/AAAA
  • AAAA/MM/DD

El T opcional es un literal que indica la hora, y el z opcional indica la hora UTC en lugar de la hora local. Para obtener más información sobre los formatos de marcas de tiempo, consulta ISO 8601.

Especifica un límite

Para especificar una cantidad máxima de filas que se mostrarán, agrega una cláusula de límite.

  1. Haz clic en Agregar a la consulta.
  2. En la lista desplegable, selecciona Limitar.
  3. Ingresa un número del 1 al 1,00.

Limitaciones

Las siguientes limitaciones se aplican al Creador de consultas.

  • 1,000 caracteres por celda: Bigtable muestra un máximo de 1,000 caracteres por celda. Si una celda contiene más de 1,000 caracteres, se muestra un resultado truncado, con la anotación de la cantidad de caracteres que no se muestran.
  • Máximo de 100 columnas: Bigtable muestra las primeras 100 columnas de cada fila que coinciden con la consulta. Las familias de columnas no se almacenan en ningún orden en particular, pero las columnas se ordenan lexicográficamente dentro de su familia de columnas.
  • 1,000 filas como máximo: El Creador de consultas muestra un máximo de las primeras 1,000 filas de datos que coinciden con tu consulta.
  • Base64: Bigtable hace todo lo posible para mostrar con precisión los datos codificados en Base64, pero no se garantizan los resultados. Si Bigtable no puede mostrar los datos de una celda, muestra el tamaño del valor de la celda en bytes.

  • Datos más antiguos: Solo puedes recuperar la celda (o la versión) más reciente en las columnas que consultas. Para obtener más información sobre este concepto, consulta el modelo de almacenamiento de Bigtable y Conceptos generales.

  • Datos serializados: Los datos almacenados como búferes de protocolo no se muestran correctamente en los resultados de la consulta. Los datos JSON son más compatibles, pero no se garantiza que se vean bien.

  • Marcas de tiempo artificiales: Si tu aplicación asigna números que no son de marca de tiempo a la propiedad de marca de tiempo de las celdas cuando escribe datos en tu tabla, puedes usar filtros de intervalo de tiempo en tu consulta para obtener un rango de los valores que usas en lugar de marcas de tiempo, siempre que los especifiques como microsegundos. Para comprender por qué los datos de tu tabla podrían usar marcas de tiempo artificiales, consulta Marcas de tiempo.

¿Qué sigue?