Crea y administra tablas

Console

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

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

   Abrir la lista de instancias

2. Haz clic en la instancia que tiene las tablas deseas ver.

3. Haz clic en Tablas en el panel izquierdo.

   En la página Tablas, se mostrará una lista de tablas de la instancia.

4. Ingresa un ID para la tabla.

5. Agrega familias de columnas (opcional)

   Puedes agregar columnas ahora o más tarde. Una tabla debe tener al menos una familia de columnas antes de poder escribir datos en ella. Una tabla debe tener al menos una familia de columnas antes de poder escribir datos en ella o leer un flujo de cambios desde ella.

6. Opcional: Habilita un flujo de cambios para la tabla. Antes de habilitar un flujo de cambios, asegúrate de comprender las implicaciones, incluidos los costos de almacenamiento adicionales y los requisitos de uso del perfil de app. Para revisar estos detalles, consulta la descripción general de los flujos de cambios.

   1. Selecciona Habilitar el flujo de cambios.

   2. En el campo Tiempo de vencimiento, ingresa un número entre 1 y 7 para especificar la cantidad de días que se deben retener 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 de verificación junto a Habilitar la copia de seguridad automática. Para obtener más información, consulta Cómo usar la copia de seguridad automática (versión preliminar).

8. Haz clic en Crea una tabla.

gcloud

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

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

Reemplaza lo siguiente:

• TABLE_ID: Un ID único para la tabla nueva
• INSTANCE_ID: El ID de la instancia
• PROJECT_ID: Es el proyecto que contendrá la tabla nueva.
• COLUMN-FAMILIES: Es una lista separada por comas de nombres de familia de columnas. Puedes agregar más familias de columnas más adelante.

Opcional:

• Para proteger la tabla contra la eliminación, agrega el comando con --deletion-protection. Si no aplicas este parámetro de configuración, se puede borrar la tabla. También puedes permitir de forma explícita la eliminación de tablas si agregas --no-deletion-protection.

• Para habilitar un flujo de cambios para la tabla, especifica un período de retención para los datos del flujo de cambios. Antes de habilitar un flujo de cambios, asegúrate de comprender las implicaciones, incluidos los mayores costos de almacenamiento y los requisitos de uso del perfil de app. Para revisar estos detalles, consulta la descripción general de los flujos de cambios.

  --change-stream-retention-period=RETENTION_PERIOD
  

  Reemplaza RETENTION_PERIOD por el período durante el que Bigtable debe retener los datos del flujo de cambios de la tabla. El tiempo debe ser de uno a siete días. Las unidades aceptables 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, habilita la copia de seguridad automática (versión preliminar):

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

cbt

Usa el siguiente comando y reemplaza TABLE_NAME por el nombre de tu tabla. No puedes usar la CLI de cbt para crear una tabla con un flujo de cambios habilitado.

cbt createtable TABLE_ID

Opcional: Para crear una familia de columnas aggregate en la tabla, agrega el nombre de la familia de columnas con el tipo de agregación. El siguiente fragmento de código crea una familia de columnas agregadas con una política de recolección de elementos no utilizados de never.

cbt createtable TABLE_ID families=FAMILY_NAME:never:TYPE

Reemplaza lo siguiente:

• TABLE_ID: Un ID único para la tabla nueva
• FAMILY_NAME: Es una lista separada por comas de nombres de familia de columnas. Puedes agregar más familias de columnas más adelante.
• TYPE: Es el tipo de agregado. Debe ser intsum, intmin, intmax o inthll.

Console

No puedes dividir antes las filas cuando creas una tabla con la consola de Google Cloud.

gcloud

Para dividir una tabla por clave de fila, ejecuta el siguiente comando. Consulta gcloud bigtable instances tables create para obtener una lista completa de las opciones.

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

Reemplaza lo siguiente:

• TABLE_ID: Un ID único para la tabla nueva
• INSTANCE_ID: El ID de la instancia
• PROJECT_ID: Es el proyecto que contendrá la tabla nueva.
• COLUMN-FAMILIES: Es una lista separada por comas de nombres de familia de columnas. Puedes agregar más familias de columnas más adelante.
• SPLITS: Son las claves de fila en las que la tabla debe dividirse inicialmente, por ejemplo, 10,20.

cbt

Para dividir una tabla antes según la clave de fila, usa la siguiente sintaxis para crear la tabla. Reemplaza [TABLE_NAME] por el nombre de la tabla y [SPLITS] por una lista separada por comas de los prefijos de clave de fila que se usarán para las divisiones previas.

```
cbt createtable [TABLE_NAME] splits=[SPLITS]
```

Por ejemplo, para dividir antes la tabla my-table en las claves de fila que comienzan con 10 y 20, ingresa el siguiente comando:

```
cbt createtable my-table splits=10,20
```

Console

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

   Abrir la lista de instancias

2. Haz clic en la instancia que tiene las tablas deseas ver.

3. Haz clic en Tablas en el panel izquierdo.

   En la página Tablas, se mostrará una lista de tablas de la instancia.

4. Haz clic en edit Editar en la tabla que deseas modificar.

5. Para cada familia de columnas que desees agregar, completa lo siguiente:

   1. Haz clic en Agregar familia de columnas.
   2. Proporciona un identificador único para la familia de columnas.
   3. Establece la política de recolección de elementos no utilizados para la familia de columnas.
   4. Haga clic en Listo.
   5. Haz clic en Guardar.

gcloud

No puedes usar gcloud CLI para agregar familias de columnas a una tabla.

cbt

Para agregar una familia de columnas a una tabla, usa el siguiente comando:

cbt createfamily TABLE_ID FAMILY_NAME

Por ejemplo, ingresa el siguiente comando para agregar las familias de columnas cf1 y cf2 a la tabla my-table:

cbt createfamily my-table cf1
cbt createfamily my-table cf2

Opcional: Para agregar una familia de columnas aggregate a la tabla, agrega el nombre de la familia de columnas con el tipo de agregación. El siguiente comando crea una tabla que tiene una familia de columnas agregadas con una política de recolección de elementos no utilizados de never.

cbt createfamily TABLE_ID FAMILY_NAME:never:TYPE

Reemplaza lo siguiente:

• TABLE_ID: el ID de la tabla
• FAMILY_NAME: Es una lista separada por comas de nombres de familia de columnas. Puedes agregar más familias de columnas más adelante.
• TYPE: Es el tipo de agregación. Debe ser intsum, intmin, intmax o inthll.

Console

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

   Abrir la lista de instancias

2. Haz clic en la instancia que tiene las tablas deseas ver.

3. Haz clic en Tablas en el panel izquierdo.

   En la página Tablas, se mostrará una lista de tablas de la instancia.

4. Haz clic en edit Editar en la tabla que deseas modificar.

5. Para cada familia de columnas que desees borrar, completa los siguientes pasos:

   1. Coloca el cursor sobre la fila de la familia de columnas que desees borrar.
   2. Haga clic en delete.

6. Haz clic en Guardar.

7. Para confirmar que comprendes que la eliminación de una familia de columnas es permanente y que todos los datos en la familia de columnas se borrarán, escribe “Borrar familias de columnas” en el campo de texto.

8. Haz clic en Confirmar.

gcloud

No puedes usar gcloud CLI para borrar familias de columnas de una tabla.

cbt

Usa el siguiente comando para borrar una familia de columnas de una tabla y reemplaza [TABLE_NAME] con el nombre de la tabla y [FAMILY_NAME] con el nombre de la familia de columnas:

cbt deletefamily [TABLE_NAME] [FAMILY_NAME]

Por ejemplo, ingresa el siguiente comando para borrar la familia de columnas cf2 de la tabla my-table:

cbt deletefamily my-table cf2

Console

Sigue estos pasos para ver una lista de tablas en una instancia:

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

   Abrir la lista de instancias

2. Haz clic en la instancia que tiene las tablas deseas ver.

3. Haz clic en Tablas en el panel izquierdo.

   En la página Tablas, se mostrará una lista de tablas de la instancia.

   • Haz clic en la flecha al lado del ID de la tabla para expandir una lista de replicaciones de la tabla.
   • Haz clic en Ver métricas junto al nombre de una tabla para ver los datos de supervisión de la tabla.

gcloud

Para ver una lista de tablas, ejecuta el comando gcloud bigtable instances tables list.

gcloud bigtable instances tables list --instances=INSTANCE_IDS

Reemplaza lo siguiente:

• INSTANCE_IDS: Es una lista de IDs de instancias separadas por comas.

cbt

Ejecuta el siguiente comando para ver una lista de tablas en una instancia:

    cbt ls INSTANCE_ID

Reemplaza lo siguiente:

• INSTANCE_ID: Es el identificador permanente de la instancia.

C++

namespace cbt = ::google::cloud::bigtable;
namespace cbta = ::google::cloud::bigtable_admin;
using ::google::cloud::StreamRange;
[](cbta::BigtableTableAdminClient admin, std::string const& project_id,
   std::string const& instance_id) {
  std::string instance_name = cbt::InstanceName(project_id, instance_id);

  google::bigtable::admin::v2::ListTablesRequest r;
  r.set_parent(instance_name);
  r.set_view(google::bigtable::admin::v2::Table::NAME_ONLY);

  StreamRange<google::bigtable::admin::v2::Table> tables =
      admin.ListTables(std::move(r));
  for (auto& table : tables) {
    if (!table) throw std::move(table).status();
    std::cout << table->name() << "\n";
  }
}

C#

// Lists tables in intance.
// Initialize request argument(s).
ListTablesRequest request = new ListTablesRequest
{
    ParentAsInstanceName = s_instanceName
};
try
{
    // Make the request.
    PagedEnumerable<ListTablesResponse, Table> response = bigtableTableAdminClient.ListTables(request);

}
catch (Exception ex)
{
    Console.WriteLine($"Error listing tables {ex.Message}");
}

Java

// Lists tables in the current instance.
try {
  List<String> tableIds = adminClient.listTables();
  for (String tableId : tableIds) {
    System.out.println(tableId);
  }
} catch (NotFoundException e) {
  System.err.println("Failed to list tables from a non-existent instance: " + e.getMessage());
}

Node.js

// List tables in current project
const [tables] = await instance.getTables();
tables.forEach(table => {
  console.log(table.id);
});

PHP

use Google\Cloud\Bigtable\Admin\V2\Client\BigtableInstanceAdminClient;
use Google\Cloud\Bigtable\Admin\V2\Client\BigtableTableAdminClient;
use Google\Cloud\Bigtable\Admin\V2\ListTablesRequest;

/**
 * List tables in an instance
 *
 * @param string $projectId The Google Cloud project ID
 * @param string $instanceId The ID of the Bigtable instance
 */
function list_tables(
    string $projectId,
    string $instanceId
): void {
    $instanceAdminClient = new BigtableInstanceAdminClient();
    $tableAdminClient = new BigtableTableAdminClient();

    $instanceName = $instanceAdminClient->instanceName($projectId, $instanceId);

    printf('Listing Tables:' . PHP_EOL);
    $listTablesRequest = (new ListTablesRequest())
        ->setParent($instanceName);
    $tables = $tableAdminClient->listTables($listTablesRequest)->iterateAllElements();
    $tables = iterator_to_array($tables);
    if (empty($tables)) {
        print('No table exists.' . PHP_EOL);
        return;
    }
    foreach ($tables as $table) {
        print($table->getName() . PHP_EOL);
    }
}

Python

tables = instance.list_tables()
print("Listing tables in current project...")
if tables != []:
    for tbl in tables:
        print(tbl.table_id)
else:
    print("No table exists in current project...")

Ruby

# instance_id = "my-instance"
bigtable.tables(instance_id).all.each do |t|
  puts "Table: #{t.name}"
end

Console

Para ver información sobre una tabla, haz lo siguiente:

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

   Abrir la lista de instancias

2. Haz clic en la instancia que tiene las tablas deseas ver.

3. Haz clic en Tablas en el panel izquierdo.

   En la página Tablas, se mostrará una lista de tablas de la instancia. Para cada tabla, la consola de Google Cloud muestra la cantidad de clústeres en los que se almacena la tabla, el estado de la tabla, el uso del almacenamiento y los identificadores de cualquier copia de seguridad actual de la tabla.

4. Para ver los nombres de las familias de columnas de la tabla, haz clic en edit. Para cerrar el panel Editar tabla, haz clic en Cancelar.

5. Para ver detalles adicionales sobre la tabla, incluidas las métricas a nivel de tabla y el estado de replicación, haz clic en el nombre de la tabla.

gcloud

Para ver información sobre una tabla, ejecuta el comando gcloud bigtable instances tables describe.

gcloud bigtable instances tables describe TABLE_ID \
    --instance=INSTANCE_ID

Reemplaza lo siguiente:

• TABLE_ID: Un ID único de la tabla
• INSTANCE_ID: El ID de la instancia

cbt

Puedes usar la CLI de cbt para obtener una lista de las familias de columnas existentes en una tabla.

Usa el siguiente comando y reemplaza [TABLE_NAME] por el nombre de la tabla:

cbt ls [TABLE_NAME]

Console

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

   Abrir la lista de instancias

2. Haz clic en la instancia que tiene las tablas deseas ver.

3. Haz clic en Tablas en el panel izquierdo.

   En la página Tablas, se mostrará una lista de tablas de la instancia.

4. Haz clic en more_vert en la tabla que deseas borrar.

5. Haz clic en Borrar.

6. Para confirmar que entiendes que esta acción borrará la tabla de todos los clústeres de la instancia y que solo tienes siete días a fin de recuperarla, escribe el ID de la tabla en el cuadro de texto.

7. Haz clic en Borrar.

gcloud

1. Para borrar tablas, ejecuta el comando gcloud bigtable instances tables delete.

   gcloud bigtable instances tables delete --instance=INSTANCE_ID
   

   Reemplaza lo siguiente:

   • INSTANCE_ID: El ID de la instancia

2. En la terminal, ingresa y para confirmar la eliminación de la tabla.

cbt

Para borrar una tabla, usa el siguiente comando y reemplaza [TABLE_NAME] por el nombre de la tabla:

cbt deletetable [TABLE_NAME]

Console

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

   Abrir la lista de instancias

2. Haz clic en la instancia que tiene las tablas deseas ver.

3. Haz clic en Tablas en el panel izquierdo.

   En la página Tablas, se mostrará una lista de tablas de la instancia.

4. Haz clic en more_vert junto al ID de la tabla.

5. Para habilitar la protección contra la eliminación, haz clic en Evitar la eliminación. Para inhabilitar la protección contra la eliminación, haz clic en Habilitar eliminación. Solo se muestra la opción válida.

gcloud

Para habilitar la protección contra la eliminación de una tabla, ejecuta el comando gcloud bigtable instances table update:

gcloud bigtable instances tables update TABLE_ID \
    --instance=INSTANCE_ID \
    --deletion-protection

Para inhabilitar la protección contra la eliminación de una tabla, ejecuta lo siguiente:

gcloud bigtable instances tables update TABLE_ID \
    --instance=INSTANCE_ID \
    --no-deletion-protection

Reemplaza lo siguiente:

+ TABLE_ID: the unique identifier for the table
+ INSTANCE_ID: the ID of the instance

cbt

No puedes usar la CLI de cbt para habilitar o inhabilitar la protección contra eliminación.