Compila consultas en la consola

Puedes consultar y visualizar tus datos de Bigtable con el Bigtable Studio compilador de consultas. 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 llama a la API de Bigtable Data, que devuelve datos que coinciden con tu consulta.

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

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 una representación visual del esquema de tu tabla con rapidez.
  • Verifica que ciertos datos se hayan escrito correctamente.
  • Valida la integridad de los datos durante una migración.
  • Depurar posibles problemas de datos
  • Obtener una vista previa de los resultados que devuelve una combinación específica de cláusulas antes las usas en tu código. Esto puede ser especialmente útil para los los usuarios de Bigtable y los usuarios experimentados que no quieren el CLI de cbt de Google Cloud.

Antes de comenzar

A fin de obtener los permisos que necesitas para usar el compilador de consultas, solicita 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 compilador 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 crea una tabla de prueba pequeña y ejecutar consultas en él.

Abre el compilador de consultas

Cuando abres el compilador de consultas, se ejecuta una consulta predeterminada que se muestra primera tabla alfabéticamente en la instancia. La consulta predeterminada se ejecuta con el 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 quieres para cada búsqueda.

  3. En el panel de navegación, haz clic en Bigtable Studio. Bigtable Studio se abrirá en el modo Compilador de consultas. El panel Explorador proporciona una lista de tablas en la instancia, y en el panel Resultados de la consulta se muestran los resultados de la consulta predeterminada.

  4. Opcional: Contrae el panel Explorador para crear el panel del compilador de consultas más grande.

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. Cada uno de los encabezados restantes representa una columna en el Tabla de Bigtable, expresada como la familia de columnas y la columna calificador separado por dos puntos. Por ejemplo, el encabezado cell_plan: data_plan_01gb indica que los valores de esa columna son de Columna data_plan_01gb en la familia de columnas cell_plan

desplegable

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

Seleccionar una tabla

Usa el menú desplegable Tabla para seleccionar el ID de la tabla que deseas agregar. para cada búsqueda.

Opcional: Especifica un perfil de app

Puedes usar un perfil de app que crees específicamente para usar con la consulta generador del sitio web. Esto puede ser útil, por ejemplo, cuando quieres aislar la consulta el tráfico con un clúster diferente al que que usa tu aplicación principal.

Si quieres usar otro perfil de app para ejecutar tu próxima consulta, sigue estos pasos.

  1. Haz clic en Agregar a la consulta.
  2. Haz clic en Cambiar perfil de app (predeterminado). Se mostrará 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 los distintos perfiles de app para diferentes de Google Workspace, consulta Acerca de la app perfiles de Google Cloud. Si deseas obtener información para crear un perfil de app, consulta Cómo crear y configurar una app. perfiles de Google Cloud.

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 se encuentra más cerca de ti geográficamente.

Agregar cláusulas a la consulta y ejecutarla.

  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 más detalles sobre las cláusulas disponibles.
  2. Después de agregar todas las cláusulas, haz clic en Ejecutar.
  3. Observa los resultados.

Cláusulas de consulta

Usa 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 aprender 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 intervalo de tiempo agregan un filtro para la solicitud de lectura generada. Los filtros que usas en la consulta 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 de inicio y de finalización. Bigtable almacena los datos en orden lexicográfico según la 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, haz lo siguiente: filtrar 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 vertical u otro símbolo entre las y el resto de la clave de fila.

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

Filtrar por regex de clave de fila

Para obtener solo las filas cuyos valores de clave de fila coincidan con una expresión regular especificada, usa un filtro de regex de clave de fila. Para mejorar el rendimiento, agrega un rango de claves 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. Orientación para redactar tu regex, consulta Clave de fila regex de Google Cloud.

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

Filtrar por columna

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

  1. Haz clic en Agregar a la consulta.
  2. En la lista desplegable, selecciona Columnas.
  3. Haz clic en el campo Columnas. Aparecerá una lista de familias de columnas.
  4. Haz clic en un ID de 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 celdas con una marca de tiempo dentro de un cierto rango, agrega un intervalo de tiempo que usa el rango de marca de tiempo filtro de Google Cloud.

  1. Haz clic en Agregar a la consulta.
  2. En la lista desplegable, selecciona Intervalo 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. Más información sobre la marca de tiempo estándares, consulta ISO 8,601 de Google Cloud.

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 Límite.
  3. Ingrese un número del 1 al 1,00.

Limitaciones

Las siguientes limitaciones se aplican al compilador de consultas.

  • 1,000 caracteres por celda: Bigtable muestra un hasta 1,000 caracteres por celda. Si una celda contiene más de 1,000 caracteres, se muestra un resultado truncado, anotado con la cantidad de caracteres que no se muestran.
  • 100 columnas como máximo: Bigtable muestra las primeras 100. columnas en cada fila que coincidan 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 su mejor esfuerzo para brindar un mostrar datos codificados en Base64, pero los resultados no están garantizados. Si Bigtable no puede mostrar los datos en una celda, se muestran 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: No se muestran los datos almacenados como búferes de protocolo. correctamente en los resultados de la consulta. Se admiten mejor los datos JSON, pero no que se ve bien.

  • Marcas de tiempo artificiales: Si la aplicación asigna marcas de tiempo a la propiedad de marca de tiempo de las celdas cuando escribe datos tabla, puedes usar filtros de intervalo de tiempo en tu consulta para obtener un intervalo de valores que uses en lugar de marcas de tiempo, siempre que los especifiques microsegundos. Para entender por qué los datos de tu tabla pueden usar datos marcas de tiempo, consulta Marcas de tiempo

¿Qué sigue?