Crear consultas en la consola

Puedes consultar y ver tus datos de Bigtable mediante el generador de consultas de Bigtable Studio. El creador de consultas es un formulario interactivo de la consola Google Cloud que te permite crear una consulta, ejecutarla en una tabla y, a continuación, ver los resultados en la consola.

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

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

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

Cuándo usar la herramienta para crear consultas

La posibilidad de consultar tus datos de Bigtable en la consolaGoogle Cloud te resulta útil cuando necesitas hacer lo siguiente:

  • Obtén rápidamente una representación visual del esquema de tu tabla.
  • Verificar que determinados datos se han escrito correctamente.
  • Validar la integridad de los datos durante una migración.
  • Depura posibles problemas con los datos.
  • Previsualiza los resultados que devuelve una combinación específica de cláusulas antes de usarlas en tu código. Esto puede ser especialmente útil para los nuevos usuarios de Bigtable, así como para los usuarios experimentados que no quieran usar la CLI cbt .

Antes de empezar

Para obtener los permisos que necesitas para usar el creador de consultas, pide a tu administrador que te conceda el rol de gestión de identidades y accesos Lector de Bigtable (roles/bigtable.reader) en el proyecto. Para obtener más información sobre cómo conceder roles, consulta el artículo Gestionar 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 se necesitan, despliega la sección Permisos necesarios:

Permisos obligatorios

Para usar el creador de consultas, se necesitan los siguientes permisos:

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

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

Si no tienes ninguna tabla para hacer consultas, puedes crear una tabla de prueba pequeña y hacer consultas en ella.

Abrir la herramienta para crear consultas

Cuando abres el creador de consultas, se ejecuta una consulta predeterminada y se muestra la primera tabla alfabéticamente de la instancia. La consulta predeterminada se ejecuta con el perfil de aplicación predeterminado y se devuelven hasta 100 filas.

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

    Abrir la lista de instancias

  2. Haga clic en el nombre de la instancia que contiene la tabla que quiere consultar.

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

  4. Opcional: Colapsa el panel Explorador para que el panel del creador de consultas sea más grande.

Formato de visualización de datos

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

Desplegable

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

Selecciona una tabla

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

Opcional: Especificar un perfil de aplicación

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

Para usar otro perfil de aplicación en la próxima consulta, sigue estos pasos.

  1. Haz clic en Añadir a la consulta.
  2. Haz clic en Cambiar perfil de la aplicación (predeterminado). Se mostrará un nuevo menú desplegable.
  3. Usa el menú desplegable Perfil de aplicación y elige uno de la lista de perfiles de aplicación de la instancia.

Para obtener más información sobre las ventajas de usar diferentes perfiles de aplicación para distintas cargas de trabajo, consulta el artículo Acerca de los perfiles de aplicación. Para saber cómo crear un perfil de aplicación, consulta Crear y configurar perfiles de aplicación.

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

Añade cláusulas a la consulta y, a continuación, ejecútala

  1. Una vez que hayas seleccionado la tabla y el perfil de aplicación, añade cláusulas a la consulta. Consulta la siguiente sección para obtener información detallada sobre las cláusulas disponibles.
  2. Cuando hayas añadido todas las cláusulas, haz clic en Ejecutar.
  3. Consulta los resultados.

Cláusulas de consulta

Utiliza el creador de consultas para añadir cláusulas a tu consulta. Cuando ejecutas la consulta, el creador 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, intervalo de claves de fila y prefijo de clave de fila determinan las filas que se obtienen del almacenamiento. Las cláusulas de expresión regular de la clave de fila, las columnas y el intervalo de tiempo añaden un filtro a la solicitud de lectura generada. Los filtros que usas en el creador de consultas funcionan igual que cuando los usas en las bibliotecas de cliente. Para obtener más información sobre los filtros de Bigtable y cómo pueden afectar al rendimiento, consulta los artículos Filtros y Usar filtros.

Especificar la clave de la fila

Para obtener una sola fila de la tabla, proporciona un valor de clave de fila. Puedes añadir varias cláusulas de clave de fila.

  1. Haz clic en Añadir a la consulta.
  2. En la lista desplegable, selecciona Clave de fila.
  3. Introduzca el valor exacto de la clave de fila de la que quiera ver los valores.

Especificar un intervalo de claves de fila

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

  1. Haz clic en Añadir a la consulta.
  2. En la lista desplegable, selecciona Intervalo de claves de fila.
  3. Introduce la clave de la fila inicial completa.
  4. Introduce la clave de la fila final completa.

Especificar un prefijo de clave de fila

Para recuperar solo las filas cuyas claves de fila empiecen por un conjunto específico de caracteres, filtra por prefijo de clave de fila. Un prefijo de clave de fila son los primeros N caracteres de una clave de fila. Por convención, suele haber un hashtag, una barra vertical u otro símbolo entre el prefijo y el resto de la clave de fila.

  1. Haz clic en Añadir a la consulta.
  2. En la lista desplegable, selecciona Prefijo de clave de fila.
  3. Introduce un prefijo de clave de fila. No es necesario que introduzcas ningún símbolo de 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, utilice un filtro de expresión regular de clave de fila. Para mejorar el rendimiento, añade una cláusula de intervalo o prefijo de clave de fila a la consulta antes de añadir el filtro de expresión regular de clave de fila. Para obtener información sobre cómo crear tu expresión regular, consulta Expresión regular de clave de fila.

  1. Haz clic en Añadir a la consulta.
  2. En la lista desplegable, selecciona Expresión regular de clave de fila.
  3. Introduce una expresión regular que utilice la sintaxis de re2.

Filtrar por columna

Para especificar una o varias columnas que se incluirán en la consulta, añade una cláusula columns y elige la familia de columnas y el calificador de columna de cada columna por la que quieras filtrar. La solicitud de lectura que se genera al añadir esta cláusula incluye el filtro de regex de familia de columnas y el filtro de intervalo de columnas.

  1. Haz clic en Añadir a la consulta.
  2. En la lista desplegable, selecciona Columnas.
  3. Haga clic en el campo Columnas. Se muestra una lista de familias de columnas.
  4. Haz clic en un ID de familia de columnas. Se muestra una lista de calificadores de columna.
  5. Haz clic en un calificador de columna.

Filtrar por periodo

Para recuperar solo las celdas con una marca de tiempo dentro de un intervalo determinado, añade una cláusula de intervalo de tiempo, que usa el filtro de intervalo de marcas de tiempo.

  1. Haz clic en Añadir a la consulta.
  2. En la lista desplegable, selecciona Intervalo de tiempo.
  3. Introduce una marca de tiempo de inicio.
  4. Introduce una marca de tiempo de finalización.

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

  • 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 elemento opcional T es un literal que indica la hora, y el elemento opcional z indica la hora UTC en lugar de la hora local. Para obtener más información sobre los formatos de marca de tiempo, consulta la norma ISO 8601.

Especificar un límite

Para especificar el número máximo de filas devueltas, añade una cláusula LIMIT.

  1. Haz clic en Añadir a la consulta.
  2. En la lista desplegable, selecciona Límite.
  3. Introduce un número entre 1 y 100.

Limitaciones

Se aplican las siguientes limitaciones al creador de consultas.

  • 1000 caracteres por celda: Bigtable devuelve un máximo de 1000 caracteres por celda. Si una celda contiene más de 1000 caracteres, se muestra un resultado truncado, anotado con el número de caracteres que no se muestran.
  • Máximo de 100 columnas: Bigtable devuelve las primeras 100 columnas de cada fila que coincidan con la consulta. Las familias de columnas no se almacenan en ningún orden concreto, pero las columnas se ordenan lexicográficamente dentro de su familia de columnas.
  • Máximo de 1000 filas: el creador de consultas devuelve un máximo de las primeras 1000 filas de datos que coinciden con tu consulta.
  • Base64 Bigtable hace todo lo posible para mostrar los datos codificados en Base64 de forma precisa, pero no se garantiza que los resultados sean correctos. Si Bigtable no puede mostrar los datos de una celda, muestra el tamaño del valor de la celda en bytes.

  • Datos antiguos: solo puedes recuperar la celda (o la versión) más reciente de las columnas que consultes. Para obtener más información sobre este concepto, consulta el modelo de almacenamiento de Bigtable y los 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 se admiten mejor, pero no se garantiza que se muestren correctamente.

  • Marcas de tiempo artificiales: si tu aplicación asigna números que no son marcas 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 intervalo de los valores que usas en lugar de marcas de tiempo, siempre que los especifiques como microsegundos. Para saber por qué los datos de tu tabla pueden usar marcas de tiempo artificiales, consulta Marcas de tiempo.

Siguientes pasos