Crear y gestionar tablas

En esta página se explica cómo crear tablas de Bigtable y realizar operaciones en ellas con la Google Cloud consola, la CLI de Google Cloud o la CLI de cbt.

La CLI de cbt admite varios comandos que no se describen en esta página. Para ver una lista completa de los comandos, consulta la referencia de cbt.

También puedes crear y gestionar tablas de forma programática con las bibliotecas de cliente o las APIs de servicio de Cloud Bigtable.

Para obtener instrucciones sobre cómo crear y gestionar vistas autorizadas de una tabla, consulta el artículo sobre vistas autorizadas.

Antes de empezar

Si tienes previsto trabajar con tus tablas mediante herramientas de línea de comandos, sigue los pasos de esta sección.

  1. Instala gcloud CLI.

  2. Opcional: Si tienes previsto usar la CLI de cbt, sigue las instrucciones de Instalar la CLI de cbt , incluido el paso para crear un archivo .cbtrc.

    Las instrucciones de la CLI cbt de esta página presuponen que has definido el ID del proyecto y el ID de la instancia en el archivo .cbtrc. También puedes usar las marcas -project y -instance para definir estos valores cada vez que ejecutes un comando de la cbt CLI.

Crear una tabla

Cuando creas una tabla, no tienes que especificar las familias de columnas que se van a usar en ella. Puedes añadir o eliminar familias de columnas más adelante.

Consola

Para crear una tabla en una instancia, sigue estos pasos:

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

    Abrir la lista de instancias

  2. Haz clic en la instancia cuyas tablas quieras ver.

  3. En el panel de la izquierda, haz clic en Tablas.

    En la página Tablas se muestra una lista de las tablas de la instancia.

  4. Introduzca el ID de la tabla.

  5. Añade familias de columnas (opcional).

    Puedes añadir columnas ahora o más adelante. Una tabla debe tener al menos una familia de columnas para poder escribir datos en ella. Una tabla debe tener al menos una familia de columnas para poder escribir datos en ella o leer un flujo de cambios.

  6. Opcional: Habilita un flujo de cambios en la tabla. Antes de habilitar un flujo de cambios, asegúrate de que comprendes las implicaciones, como el aumento de los costes de almacenamiento y los requisitos de uso del perfil de la aplicación. Para consultar estos detalles, consulta la descripción general de los flujos de cambios.

    1. Selecciona Habilitar flujo de cambios.

    2. En el campo Tiempo de caducidad, introduce un número del 1 al 7 para especificar el número de días que se deben conservar los datos del flujo de cambios.

    3. Haz clic en Crear.

  7. Opcional: Si no quieres que Bigtable cree una copia de seguridad diaria de la tabla, desmarca la casilla situada junto a Habilitar copia de seguridad automática. Para obtener más información, consulta Usar copias de seguridad automáticas.

  8. Haz clic en Crear tabla.

gcloud

Para crear una tabla, ejecuta el siguiente comando. Consulta la gcloud bigtable instances tables create para ver la lista completa de opciones.

gcloud bigtable instances tables create TABLE_ID \
    --instance=INSTANCE_ID \
    --project=PROJECT_ID \
    --column-families=COLUMN-FAMILIES

Haz los cambios siguientes:

  • TABLE_ID: un ID único para la nueva tabla
  • INSTANCE_ID: el ID de la instancia
  • PROJECT_ID: el proyecto que contendrá la nueva tabla
  • COLUMN-FAMILIES: lista separada por comas de nombres de familias de columnas. Puedes añadir más familias de columnas más adelante.

Optional:

  • Para proteger la tabla de la eliminación, añade el comando con --deletion-protection. Si no aplicas este ajuste, la tabla se puede eliminar. También puedes permitir explícitamente la eliminación de tablas añadiendo --no-deletion-protection.

  • Para habilitar un flujo de cambios en la tabla, especifica un periodo de retención para los datos del flujo de cambios. Antes de habilitar un flujo de cambios, asegúrate de que entiendes las implicaciones, como el aumento de los costes de almacenamiento y los requisitos de uso del perfil de la aplicación. Para consultar estos detalles, consulta la descripción general de los flujos de cambios.

    --change-stream-retention-period=RETENTION_PERIOD

    Sustituye RETENTION_PERIOD por el periodo durante el que Bigtable debe conservar los datos del flujo de cambios de la tabla. El plazo debe ser de entre uno y siete días. Las unidades aceptadas son días (d), horas (h), minutos (m) y segundos (s). Ejemplos: 48h o 6d

  • Para permitir que Bigtable cree una copia de seguridad diaria de tu tabla y conserve cada copia durante el periodo de conservación predeterminado de siete días, usa la marca --enable-automated-backup al crear la tabla.

    gcloud bigtable instances tables create TABLE_ID \
    --instance=INSTANCE_ID \
    --project