Créer et gérer des tables

Les tables Bigtable vous permettent d'organiser et de stocker des données à grande échelle pour les charges de travail d'application à faible latence. Vous pouvez créer et gérer ces tables à l'aide de la console Google Cloud , de la Google Cloud CLI, de la CLI cbt ou de manière programmatique avec les bibliothèques clientes Cloud Bigtable.

Pour en savoir plus sur la création et la gestion des vues autorisées d'une table, consultez Vues autorisées.

Avant de commencer

Si vous envisagez d'utiliser vos tables à l'aide d'outils de ligne de commande, suivez la procédure décrite dans cette section.

  1. Installer gcloud CLI

  2. Facultatif : Si vous prévoyez d'utiliser la CLI cbt, suivez les instructions de la section Installer la CLI cbt , y compris l'étape de création d'un fichier .cbtrc.

    Les instructions concernant la CLI cbt décrites sur cette page supposent que vous avez défini l'ID de projet et l'ID d'instance dans votre fichier .cbtrc. Vous pouvez également utiliser les options -project et -instance pour définir ces valeurs lors de chaque exécution d'une commande de la CLI cbt.

Créer une table

Lorsque vous créez une table, vous n'avez pas besoin de spécifier les familles de colonnes qui doivent y être utilisées. Vous pourrez ajouter ou supprimer des familles de colonnes ultérieurement.

Console

Pour créer une table dans une instance, procédez comme suit :

  1. Dans la console Google Cloud , ouvrez la liste des instances Bigtable.

    Ouvrir la liste des instances

  2. Cliquez sur l'instance dans laquelle vous souhaitez créer la table.

  3. Dans le menu de navigation de Bigtable, cliquez sur Tables.

    La page Tables affiche une liste des tables de l'instance.

  4. Cliquez sur Créer une table.

  5. Dans le volet Créer une table, dans le champ ID de la table, saisissez un ID permanent pour la table.

  6. Facultatif : Ajoutez des familles de colonnes.

    Vous pouvez ajouter des familles de colonnes lors de la création de la table ou ultérieurement. Une table doit comporter au moins une famille de colonnes avant que vous puissiez y écrire des données ou y lire un flux de modifications.

  7. Facultatif : dans l'édition Enterprise Plus, pour utiliser la précision du code temporel à la microseconde, dans la section Précision du code temporel, sélectionnez Utiliser des codes temporels en microsecondes.

  8. Facultatif : activez un flux de modifications pour la table. Avant d'activer un flux de modifications, assurez-vous de bien comprendre les implications, y compris l'augmentation des coûts de stockage et les exigences d'utilisation des profils d'application. Pour en savoir plus, consultez Présentation des flux de modifications.

    1. Sélectionnez Activer le flux de modifications.

    2. Dans le champ Durée de conservation, saisissez un entier compris entre 1 et 7 pour spécifier le nombre de jours de conservation des données du flux de modifications.

  9. Facultatif : Dans la section Configurer la sauvegarde automatique, configurez les sauvegardes automatiques pour la table. Par défaut, l'option Activer la sauvegarde automatique est sélectionnée. Bigtable crée une sauvegarde standard quotidienne sur tous les clusters de l'instance et conserve chaque sauvegarde pendant sept jours. Pour en savoir plus, consultez Utiliser la sauvegarde automatique.

    • Si vous ne souhaitez pas que Bigtable crée des sauvegardes quotidiennes de la table, décochez l'option Activer la sauvegarde automatique.
    • Sur les instances SSD, pour créer des sauvegardes à chaud quotidiennes au lieu de sauvegardes standards, sélectionnez À chaud dans la section Type de sauvegarde, puis dans le champ Définir la valeur du niveau à chaud au niveau standard, saisissez un entier compris entre 1 et 10 pour spécifier le nombre de jours avant que chaque sauvegarde ne passe automatiquement à une sauvegarde standard. La valeur par défaut est de trois jours et ne peut pas dépasser la période de conservation. Vous ne pouvez pas sélectionner Hot si le stockage hiérarchisé est activé. Pour en savoir plus, consultez Configurer des sauvegardes automatiques à chaud.
    • Pour définir une durée de conservation personnalisée, dans la section Configuration de la sauvegarde, saisissez un entier compris entre 3 et 90 dans le champ Durée de conservation afin de spécifier le nombre de jours de conservation des sauvegardes.
    • Dans l'édition Enterprise Plus, pour choisir des clusters spécifiques dans lesquels Bigtable crée des sauvegardes quotidiennes, dans la section Configuration de la sauvegarde, sélectionnez les clusters dans la liste Sélectionner les clusters à sauvegarder, puis cliquez sur OK. Pour en savoir plus, consultez Configurer les emplacements des clusters de sauvegarde automatique.

  10. Facultatif : Dans la section Configurer le stockage à plusieurs niveaux, activez le stockage à accès peu fréquent pour la table dans le cadre du stockage à plusieurs niveaux (preview). Vous ne pouvez pas activer le stockage à plusieurs niveaux si l'option Chaud est sélectionnée pour les sauvegardes automatiques.

    1. Cochez la case Activer le stockage à plusieurs niveaux.

    2. Dans le champ Seuil d'âge, saisissez un entier supérieur ou égal à 30 pour spécifier le nombre de jours après lequel Bigtable déplace les données du stockage SSD vers le stockage à accès peu fréquent.

  11. Facultatif : Pour configurer le schéma de clé de ligne, sélectionnez Définir le schéma de clé de ligne, puis procédez comme suit :

    1. Dans la liste Encodage, sélectionnez un type d'encodage pour votre schéma de clé de ligne.

    2. Si vous avez sélectionné DelimitedBytes, saisissez dans le champ Délimiteur un délimiteur qui sépare les segments de vos clés de ligne existantes. La valeur par défaut est un symbole dièse (#).

    3. Dans le champ Segment, saisissez un nom pour le segment, par exemple device_type.

    4. Dans la liste Type, sélectionnez le type de données du segment de clé de ligne.

    5. Selon le type de données sélectionné, dans la liste Encodage d'octets, conservez le type d'encodage par défaut du segment de clé de ligne ou modifiez-le.

    6. Facultatif : si votre segment de clé de ligne comporte plusieurs parties, cliquez sur Ajouter un segment de clé de ligne pour ajouter des champs supplémentaires.

  12. Cliquez sur Créer.

gcloud

Pour créer une table, exécutez la commande suivante. Consultez gcloud bigtable instances tables create pour obtenir la liste complète des options.

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

Remplacez les éléments suivants :

  • TABLE_ID : identifiant unique pour la nouvelle table.
  • INSTANCE_ID : ID de l'instance
  • PROJECT_ID : projet qui contiendra la nouvelle table.
  • COLUMN_FAMILIES : liste de noms de familles de colonnes, séparés par des virgules. Vous pourrez ajouter d'autres familles de colonnes ultérieurement.

Facultatif :

  • Pour protéger la table contre la suppression, ajoutez --deletion-protection à la commande. Si vous n'appliquez pas ce paramètre, la table peut être supprimée. Vous pouvez également autoriser explicitement la suppression de tables en ajoutant --no-deletion-protection.

  • Pour activer un flux de modifications pour la table, spécifiez une durée de conservation pour les données du flux de modifications. Avant d'activer un flux de modifications, assurez-vous d'en comprendre les implications, y compris l'augmentation des coûts de stockage et les exigences d'utilisation des profils d'application. Pour en savoir plus, consultez Présentation des flux de modifications.

    --change-stream-retention-period=RETENTION_PERIOD

    Remplacez RETENTION_PERIOD par la durée pendant laquelle Bigtable doit conserver les données du flux de modifications pour la table. La durée doit être comprise entre un et sept jours. Les unités acceptées sont les jours (d), les heures (h), les minutes (m) et les secondes (s). Par exemple, 48h ou 6d.

  • Pour permettre à Bigtable de créer une sauvegarde quotidienne de votre table et de conserver chaque sauvegarde pendant la période de conservation par défaut de sept jours, utilisez l'option --enable-automated-backup lorsque vous créez votre table.

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

    Pour configurer une durée de conservation différente, utilisez l'option --automated-backup-retention-period au lieu de l'option --enable-automated-backup et indiquez une valeur allant jusqu'à 90 jours. La valeur doit être exprimée sous la forme d'un nombre avec une unité m, h ou d (minutes, heures ou jours), par exemple 15d pour 15 jours.

    Sur les instances SSD, pour configurer Bigtable afin qu'il crée des sauvegardes automatiques à chaud qui passent automatiquement à des sauvegardes standards, utilisez l'option --automated-backup-keep-hot-duration au lieu de l'option --enable-automated-backup. Indiquez une durée comprise entre 24h (1 jour) et 10d (10 jours), sans dépasser la durée de conservation. Exprimez la valeur sous forme de nombre avec une unité s, m, h ou d (secondes, minutes, heures ou jours), par exemple 24h ou 2d. Pour en savoir plus, consultez Configurer des sauvegardes automatiques à chaud.

    Édition Enterprise Plus : par défaut, Bigtable crée une sauvegarde quotidienne dans tous les clusters de l'instance de la table. Pour configurer les emplacements de cluster où Bigtable doit créer une sauvegarde quotidienne de la table, utilisez l'option --automated-backup-locations au lieu de l'option --enable-automated-backup. Fournissez une liste d'emplacements de cluster séparés par une virgule où la sauvegarde automatique doit être activée, par exemple us-central1-a,us-east1-b,europe-west1-c.

  • Pour activer l'accès peu fréquent dans le cadre du stockage hiérarchisé (preview), utilisez l'option --tiered-storage-infrequent-access-older-than :

    gcloud beta bigtable instances tables create TABLE_ID \
    --instance=INSTANCE_ID \
    --project=PROJECT_ID \
    --tiered-storage-infrequent-access-older-than=AGE_THRESHOLD

    Remplacez AGE_THRESHOLD par une valeur d'au moins 30 jours. Les unités acceptées sont les jours (d), les heures (h), les minutes (m) et les secondes (s). Par exemple, 32d ou 32d12h.

  • Pour configurer la précision du code temporel de la table, utilisez l'option --timestamp-granularity :

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

    Remplacez TIMESTAMP_GRANULARITY par le niveau de précision. La précision par défaut est la milliseconde et la valeur est MILLIS. Si vous souhaitez que la table accepte les codes temporels avec une précision à la microseconde, définissez la valeur sur MICROS. Les codes temporels d'une précision de l'ordre de la microseconde ne sont disponibles que pour les instances de l'édition Enterprise Plus.

cbt

Vous ne pouvez pas utiliser la CLI cbt pour créer une table avec un flux de modifications activé.

Pour créer une table, exécutez la commande suivante :

cbt createtable TABLE_ID

Remplacez TABLE_ID par un identifiant unique pour la nouvelle table.

Facultatif : Pour créer une famille de colonnes d'agrégation dans la table, ajoutez le type d'agrégation au nom de la famille de colonnes. La commande suivante crée une famille de colonnes d'agrégation avec une règle de récupération de mémoire de never :

cbt createtable TABLE_ID families=FAMILY_NAME:never:TYPE

Remplacez les éléments suivants :

  • TABLE_ID : identifiant unique pour la nouvelle table.
  • FAMILY_NAME : liste de noms de familles de colonnes, séparés par des virgules. Vous pourrez ajouter d'autres familles de colonnes ultérieurement.
  • TYPE : type d'agrégat. Doit être défini sur intsum, intmin, intmax ou inthll.

Pour plus d'options, consultez Créer une table dans la documentation de référence de la CLI cbt.

Si vous avez supprimé une table par erreur, n'essayez pas de la créer manuellement. Exécutez la commande gcloud CLI bigtable instances tables undelete pour récupérer la table.

Facultatif : Diviser la table en fonction d'une clé de ligne

Pour optimiser les performances, Bigtable divise en permanence les tables entre plusieurs nœuds, en répartissant de manière équitable la quantité de données stockées sur chaque nœud et en séparant, dans la mesure du possible, les lignes qui font l'objet d'accès fréquents. Ce processus continu est automatique.

Lorsque vous créez une table, vous pouvez spécifier des divisions de table initiales. Bigtable divise la table au niveau des clés de ligne que vous fournissez. Si les espaces de clés sont trop grands, Bigtable divise davantage la table. Les divisions initiales sont conservées pendant environ 24 heures après la création de la table. Vous pouvez fournir jusqu'à 100 clés de ligne dans lesquelles les divisions initiales doivent être effectuées.

Par exemple, vous pouvez désigner des lignes spécifiques pour pré-diviser votre table si vous êtes sur le point d'y écrire de nombreuses lignes.

Cette division préalable de la table n'est pas indispensable, mais elle présente des avantages, car elle fournit à Bigtable des informations sur l'endroit susceptible d'être impacté par la charge et le volume de données lors de la création de la table. La division préalable épargne à Bigtable la division des tables et le rééquilibrage de la charge concomitant à l'arrivée des données.

Console

Vous ne pouvez pas pré-diviser les lignes lorsque vous créez une table à l'aide de la consoleGoogle Cloud .

gcloud

Pour diviser une table par clé de ligne, exécutez la commande suivante. Consultez gcloud bigtable instances tables create pour obtenir la liste complète des options.

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

Remplacez les éléments suivants :

  • TABLE_ID : identifiant unique pour la nouvelle table.
  • INSTANCE_ID : ID de l'instance
  • PROJECT_ID : projet qui contiendra la nouvelle table.
  • COLUMN_FAMILIES : liste de noms de familles de colonnes, séparés par des virgules. Vous pourrez ajouter d'autres familles de colonnes ultérieurement.
  • SPLITS : clés de ligne où la table doit être initialement divisée, par exemple 10,20.

cbt

Pour effectuer une division préalable d'une table en fonction de la clé de ligne, exécutez la commande suivante :

cbt createtable TABLE_ID splits=SPLITS

Remplacez les éléments suivants :

  • TABLE_ID : identifiant unique pour la nouvelle table.
  • SPLITS : liste de préfixes de clé de ligne à utiliser pour les divisions préalables, séparés par une virgule

Par exemple, pour effectuer une division préalable de la table my-table au niveau des clés de ligne commençant par 10 et 20 :

cbt createtable my-table splits=10,20

Modifier les familles de colonnes d'une table

Vous pouvez ajouter des familles de colonnes lorsque vous créez une table ou à une table existante. Si la protection contre la suppression n'est pas activée pour la table, vous pouvez supprimer des familles de colonnes dans la table.

Ajouter des familles de colonnes

Console

Ajouter des familles de colonnes à une nouvelle table

  1. Dans le volet Créer une table, pour chaque famille de colonnes que vous souhaitez ajouter, cliquez sur Ajouter une famille de colonnes.

  2. Dans le champ Nom de la famille de colonnes, saisissez un identifiant unique pour la famille de colonnes.

  3. Choisissez le type de famille de colonnes :

  4. Si vous avez sélectionné Agrégat, dans le champ Agrégateur, sélectionnez l'une des options suivantes :

    • Somme : agrège la somme de toutes les valeurs de cellule.
    • Min : agrège la valeur minimale de la cellule.
    • Max : agrège la valeur maximale de la cellule.
    • HyperLogLog : agrège la cardinalité approximative des valeurs de cellule.

  5. Définissez la règle de récupération de mémoire pour la famille de colonnes.

  6. Cliquez sur OK.

Ajouter des familles de colonnes à une table existante

  1. Dans la console Google Cloud , ouvrez la liste des instances Bigtable.

    Ouvrir la liste des instances

  2. Cliquez sur l'instance dont vous souhaitez consulter les tables.

  3. Cliquez sur Tables dans le volet de gauche.

    La page Tables affiche une liste des tables de l'instance.

  4. Cliquez sur Modifier pour la table que vous souhaitez modifier.

  5. Pour chaque famille de colonnes que vous souhaitez ajouter, procédez comme suit :

    1. Cliquez sur Ajouter une famille de colonnes.
    2. Dans le champ Nom de la famille de colonnes, saisissez un identifiant unique pour la famille de colonnes.

    3. Choisissez le type de famille de colonnes :

    4. Si vous avez sélectionné Agrégat, dans le champ Agrégateur, sélectionnez l'une des options suivantes :

      • Somme : agrège la somme de toutes les valeurs de cellule.
      • Min : agrège la valeur minimale de la cellule.
      • Max : agrège la valeur maximale de la cellule.
      • HyperLogLog : agrège la cardinalité approximative des valeurs de cellule.

    5. Définissez la règle de récupération de mémoire pour la famille de colonnes.

    6. Cliquez sur OK.

  6. Cliquez sur Enregistrer.

gcloud

Vous ne pouvez pas utiliser la gcloud CLI pour ajouter des familles de colonnes à une table.

cbt

Pour ajouter une famille de colonnes à une table, exécutez la commande suivante :

cbt createfamily TABLE_ID FAMILY_NAME

Remplacez les éléments suivants :

  • TABLE_ID : ID de la table dans laquelle ajouter la famille de colonnes
  • FAMILY_NAME : nom de la famille de colonnes à ajouter

Par exemple, pour ajouter les familles de colonnes cf1 et cf2 à la table my-table :

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

Facultatif : Pour ajouter une famille de colonnes d'agrégation à la table, ajoutez le nom de la famille de colonnes au type d'agrégation. La commande suivante crée une table comportant une famille de colonnes d'agrégation avec une règle de récupération de mémoire de never.

cbt createfamily TABLE_ID FAMILY_NAME:never:TYPE

Remplacez les éléments suivants :

  • TABLE_ID : ID de la table
  • FAMILY_NAME : liste de noms de familles de colonnes, séparés par des virgules. Vous pourrez ajouter d'autres familles de colonnes ultérieurement.
  • TYPE : type d'agrégation. La valeur doit être intsum, intmin, intmax ou inthll.

Supprimer des familles de colonnes

Vous pouvez supprimer des familles de colonnes dans une table pour laquelle la protection contre la suppression n'est pas activée.

Console

  1. Dans la console Google Cloud , ouvrez la liste des instances Bigtable.

    Ouvrir la liste des instances

  2. Cliquez sur l'instance dont vous souhaitez consulter les tables.

  3. Cliquez sur Tables dans le volet de gauche.

    La page Tables affiche une liste des tables de l'instance.

  4. Cliquez sur Modifier pour la table que vous souhaitez modifier.

  5. Pour chaque famille de colonnes que vous souhaitez supprimer, procédez comme suit :

    1. Passez la souris sur la ligne de la famille de colonnes que vous souhaitez supprimer.
    2. Cliquez sur .

  6. Cliquez sur Enregistrer.

  7. Pour confirmer que vous comprenez que la suppression d'une famille de colonnes est définitive et que toutes les données de la famille de colonnes seront supprimées, saisissez "Supprimer les familles de colonnes" dans le champ de texte.

  8. Cliquez sur Confirmer.

gcloud

Vous ne pouvez pas utiliser la gcloud CLI pour supprimer des familles de colonnes d'une table.

cbt

Pour supprimer une famille de colonnes d'une table, exécutez la commande suivante :

cbt deletefamily TABLE_ID FAMILY_NAME

Remplacez les éléments suivants :

  • TABLE_ID : ID de la table dans laquelle supprimer la famille de colonnes
  • FAMILY_NAME : nom de la famille de colonnes à supprimer

Par exemple, pour supprimer la famille de colonnes cf2 de la table my-table :

cbt deletefamily my-table cf2

Afficher la liste des tables

Console

Pour afficher la liste de tables dans une instance :

  1. Dans la console Google Cloud , ouvrez la liste des instances Bigtable.

    Ouvrir la liste des instances

  2. Cliquez sur l'instance dont vous souhaitez consulter les tables.

  3. Cliquez sur Tables dans le volet de gauche.

    La page Tables affiche une liste des tables de l'instance.

    • Cliquez sur la flèche en regard de l'ID de la table pour développer la liste des réplications de la table.
    • Cliquez sur Afficher les métriques à côté du nom d'une table pour afficher les données d'insights système de la table.

gcloud

Pour afficher la liste des tables, exécutez la commande gcloud bigtable instances tables list :

gcloud bigtable instances tables list --instances=INSTANCE_IDS

Remplacez INSTANCE_IDS par une liste d'ID d'instances séparés par une virgule.

cbt

Pour afficher la liste des tables, exécutez la commande suivante :

cbt ls INSTANCE_ID

Remplacez INSTANCE_ID par l'identifiant permanent de l'instance.

C++

Pour savoir comment installer et utiliser la bibliothèque cliente pour Bigtable, consultez la section Bibliothèques clientes Bigtable.

Pour vous authentifier auprès de Bigtable, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local. 

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#

Pour savoir comment installer et utiliser la bibliothèque cliente pour Bigtable, consultez la section Bibliothèques clientes Bigtable.

Pour vous authentifier auprès de Bigtable, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local. 

// 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

Pour savoir comment installer et utiliser la bibliothèque cliente pour Bigtable, consultez la section Bibliothèques clientes Bigtable.

Pour vous authentifier auprès de Bigtable, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local. 

// Lists tables in the current instance.
try {
  String parent = "projects/" + projectId + "/instances/" + instanceId;
  ListTablesRequest request = ListTablesRequest.newBuilder().setParent(parent).build();
  for (Table table : adminClient.listTables(request).iterateAll()) {
    System.out.println(table.getName());
  }
} catch (NotFoundException e) {
  System.err.println("Failed to list tables from a non-existent instance: " + e.getMessage());
}

Node.js

Pour savoir comment installer et utiliser la bibliothèque cliente pour Bigtable, consultez la section Bibliothèques clientes Bigtable.

Pour vous authentifier auprès de Bigtable, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local. 

// List tables in current project
const [tables] = await adminClient.listTables({parent: instance.name});
tables.forEach(table => {
  console.log(table.name);
});

PHP

Pour savoir comment installer et utiliser la bibliothèque cliente pour Bigtable, consultez la section Bibliothèques clientes Bigtable.

Pour vous authentifier auprès de Bigtable, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local. 

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

Pour savoir comment installer et utiliser la bibliothèque cliente pour Bigtable, consultez la section Bibliothèques clientes Bigtable.

Pour vous authentifier auprès de Bigtable, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local. 

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

Pour savoir comment installer et utiliser la bibliothèque cliente pour Bigtable, consultez la section Bibliothèques clientes Bigtable.

Pour vous authentifier auprès de Bigtable, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local. 

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

Afficher les informations d'une table

Console

Pour afficher des informations sur une table, procédez comme suit :

  1. Dans la console Google Cloud , ouvrez la liste des instances Bigtable.

    Ouvrir la liste des instances

  2. Cliquez sur l'instance dont vous souhaitez consulter les tables.

  3. Cliquez sur Tables dans le volet de gauche.

    La page Tables affiche une liste des tables de l'instance. Pour chaque table, la console Google Cloud affiche le nombre de clusters sur lesquels la table est stockée, son état, son utilisation du stockage et les identifiants de toutes les sauvegardes actuelles de la table. Pour les tables pour lesquelles le stockage hiérarchisé (bêta) est activé, vous pouvez afficher l'utilisation du stockage SSD et l'utilisation du stockage Infrequent Access.

  4. Pour afficher les noms des familles de colonnes de la table, cliquez sur . Pour fermer le volet Modifier la table, cliquez sur Annuler.

  5. Pour afficher des détails supplémentaires sur la table, y compris les métriques au niveau de la table et l'état de la réplication, cliquez sur le nom de la table.

gcloud

Pour afficher des informations sur une table, exécutez la commande gcloud bigtable instances tables describe.

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

Remplacez les éléments suivants :

  • TABLE_ID : identifiant unique de la table.
  • INSTANCE_ID : ID de l'instance

cbt

Vous pouvez utiliser la CLI cbt pour obtenir la liste des familles de colonnes existantes d'une table.

Pour afficher les familles de colonnes d'une table, exécutez la commande suivante :

cbt ls TABLE_ID

Remplacez TABLE_ID par l'identifiant unique de la table.

Définir des stratégies de récupération de mémoire

Une stratégie de récupération de mémoire indique à Bigtable quelles données conserver et quelles données marquer pour suppression. Vous définissez des règles de récupération de mémoire au niveau de la famille de colonnes lors de la création de la table ou ultérieurement.

Lorsque vous créez une famille de colonnes, vous pouvez spécifier le nombre de cellules que vous souhaitez conserver dans chaque colonne de cette famille. Si vous ne définissez pas ce paramètre, Bigtable utilise l'un des paramètres par défaut suivants :

  • Si vous créez la famille de colonnes à l'aide du client Cloud Bigtable HBase pour Java ou du shell HBase, ou d'un autre outil qui utilise le client HBase pour Java, Bigtable ne conserve qu'une seule cellule pour chaque intersection de ligne ou de colonne dans la famille de colonnes. Ce paramètre par défaut est conforme à HBase.

  • Si vous créez la famille de colonnes à l'aide de la console Google Cloud , de toute autre bibliothèque cliente ou de la CLI cbt , Bigtable conserve un nombre infini de cellules dans chaque colonne.

Consultez la page Configurer des stratégies de récupération de mémoire pour obtenir des instructions détaillées sur l'affichage, la définition et la mise à jour des stratégies de récupération de mémoire.

Sauvegarder et restaurer une table

Pour savoir comment sauvegarder et restaurer une table à partir d'une sauvegarde, consultez Gérer les sauvegardes.

Si vous activez la sauvegarde automatique lorsque vous créez une table, vous pouvez modifier ultérieurement la configuration de la sauvegarde automatique de la table. Vous pouvez activer ou désactiver la sauvegarde automatique, configurer des sauvegardes automatiques à chaud sur des instances SSD, modifier la période de conservation jusqu'à 90 jours ou, dans l'édition Enterprise Plus, sélectionner les clusters dans lesquels Bigtable stocke les sauvegardes. Pour en savoir plus, consultez Utiliser la sauvegarde automatique.

Activer, désactiver ou configurer un flux de modifications

Pour obtenir des instructions sur les tâches suivantes, consultez Configurer un flux de modifications.

  • Activer un flux de modifications sur une table existante
  • Désactiver un flux de modifications
  • Mettre à jour la durée de conservation d'un flux de modifications

Supprimer une table

La suppression d'une table entraîne également la suppression de toutes les vues autorisées de la table. Si la protection contre la suppression est activée pour l'une des vues autorisées de la table, vous ne pouvez pas supprimer la table. Vous ne pouvez pas non plus supprimer une table sur laquelle repose une vue matérialisée continue.

Console

  1. Dans la console Google Cloud , ouvrez la liste des instances Bigtable.

    Ouvrir la liste des instances

  2. Cliquez sur l'instance dont vous souhaitez consulter les tables.

  3. Cliquez sur Tables dans le volet de gauche.

    La page Tables affiche une liste des tables de l'instance.

  4. Cliquez sur pour la table que vous souhaitez supprimer.

  5. Cliquez sur Supprimer.

  6. Pour confirmer que vous reconnaissez que cette action supprimera la table de tous les clusters de l'instance et que vous ne disposez que de sept jours pour annuler la suppression de la table, saisissez son ID dans la zone Supprimer la table.

  7. Cliquez sur Supprimer.

gcloud

  1. Pour supprimer des tables, exécutez la commande gcloud bigtable instances tables delete.

    gcloud bigtable instances tables delete TABLE_ID --instance=INSTANCE_ID

    Remplacez les éléments suivants :

    • TABLE_ID : identifiant unique de la table
    • INSTANCE_ID : ID de l'instance

  2. Dans le terminal, saisissez y pour confirmer la suppression de la table.

cbt

Pour supprimer une table, exécutez la commande suivante :

cbt deletetable TABLE_ID

Remplacez TABLE_ID par l'identifiant unique de la table.

Annuler la suppression d'une table

Si vous supprimez accidentellement une table, vous pouvez utiliser la commande bigtable instances tables undelete de gcloud CLI pour annuler la suppression de la table ou la récupérer. N'essayez pas de recréer manuellement la table supprimée.

Pour annuler la suppression d'une table, exécutez la commande suivante dans le terminal :

gcloud bigtable instances tables undelete TABLE_ID --instance=INSTANCE_ID

Remplacez les éléments suivants :

  • TABLE_ID: identifiant unique de la table.
  • INSTANCE_ID : ID de l'instance

Lorsque vous annulez la suppression d'une table, Bigtable active automatiquement la protection contre la suppression pour cette table.

Les limites suivantes s'appliquent :

  • La possibilité d'annuler la suppression d'une table est disponible environ sept jours à compter de la date de suppression de la table.
  • Vous ne pouvez pas annuler la suppression d'une table à l'aide de la console Google Cloud , des bibliothèques clientes Cloud Bigtable ou de la CLI cbt.
  • Vous ne pouvez pas annuler la suppression d'une table d'une instance qui a été supprimée.
  • Vous ne pouvez pas annuler la suppression d'une table sur laquelle CMEK est activé.
  • Si vous avez rétrogradé l'instance vers l'édition Enterprise, vous ne pouvez pas annuler la suppression d'une table avec une précision de code temporel en microsecondes. Pour annuler la suppression d'une table, l'instance doit être dans l'édition Enterprise Plus.
  • Lorsque vous annulez la suppression d'une table, Bigtable ne restaure pas les liaisons de stratégie IAM précises de la table supprimée.

Vous pouvez éventuellement vérifier l'état de l'opération undelete dans les journaux d'audit.

Modifier la protection contre la suppression

Vous pouvez activer ou désactiver la protection contre la suppression d'une table si vous êtes un compte principal dans un rôle incluant l'autorisation bigtable.tables.update, tel que roles/bigtable.admin. La protection contre la suppression empêche la suppression de la table, de toutes les familles de colonnes de la table et de l'instance qui contient la table.

L'activation de la protection contre la suppression pour une table ne l'active pas pour les vues autorisées de la table. De même, la désactivation de la protection contre la suppression d'une table ne la désactive pas pour les vues autorisées de la table. Vous devez mettre à jour les vues autorisées de la table séparément.

Console

  1. Dans la console Google Cloud , ouvrez la liste des instances Bigtable.

    Ouvrir la liste des instances

  2. Cliquez sur l'instance dont vous souhaitez consulter les tables.

  3. Cliquez sur Tables dans le volet de gauche.

    La page Tables affiche une liste des tables de l'instance.

  4. Cliquez sur à côté de l'ID de la table.

  5. Pour activer la protection contre la suppression, cliquez sur Empêcher la suppression. Pour désactiver la protection contre la suppression, cliquez sur Activer la suppression. Seule l'option valide est visible.

gcloud

Pour activer la protection contre la suppression d'une table, exécutez la commande gcloud bigtable instances tables update :

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

Remplacez les éléments suivants :

  • TABLE_ID: identifiant unique de la table.
  • INSTANCE_ID : ID de l'instance

Pour désactiver la protection contre la suppression pour une table, exécutez la commande suivante :

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

Remplacez les éléments suivants :

  • TABLE_ID: identifiant unique de la table.
  • INSTANCE_ID : ID de l'instance

cbt

Vous ne pouvez pas utiliser la CLI cbt pour activer ou désactiver la protection contre la suppression.

Modifier le seuil d'âge de l'espace de stockage Infrequent Access

Vous pouvez modifier à tout moment le seuil d'âge de l'accès peu fréquent qui fait partie du stockage hiérarchisé.

Console

  1. Dans la console Google Cloud , ouvrez la liste des instances Bigtable.

    Ouvrir la liste des instances

  2. Cliquez sur l'instance dont vous souhaitez consulter les tables.

  3. Cliquez sur Tables dans le volet de gauche.

    La page Tables affiche une liste des tables de l'instance.

  4. Cliquez sur Modifier pour la table que vous souhaitez modifier.

  5. Dans le champ Seuil d'âge, saisissez le nouveau nombre de jours après lequel Bigtable déplace les données du stockage SSD vers le stockage à accès peu fréquent. Le nombre doit être supérieur ou égal à 30.

gcloud

Pour modifier le seuil d'âge du stockage à accès infrequent, exécutez la commande gcloud beta bigtable instances tables update avec l'option --tiered-storage-infrequent-access-older-than :

gcloud beta bigtable instances tables update TABLE_ID \
    --instance=INSTANCE_ID \
    --project=PROJECT_ID \
    --tiered-storage-infrequent-access-older-than=AGE_THRESHOLD

Remplacez les éléments suivants :

  • TABLE_ID : ID de la table que vous souhaitez mettre à jour
  • INSTANCE_ID : ID de l'instance
  • PROJECT_ID : projet contenant la table que vous souhaitez mettre à jour
  • AGE_THRESHOLD : limite d'ancienneté, qui doit être d'au moins 30 jours. Les unités acceptables sont les jours (d), les heures (h), les minutes (m) et les secondes (s). Par exemple, de 32d précédemment à 33d.

Désactiver le stockage Infrequent Access

Vous pouvez désactiver l'accès peu fréquent au stockage hiérarchisé à tout moment. Par conséquent, Bigtable déplace toutes les données du stockage Infrequent Access vers le stockage SSD. Avant de désactiver le stockage Infrequent Access, assurez-vous de bien comprendre les implications financières.

Console

  1. Dans la console Google Cloud , ouvrez la liste des instances Bigtable.

    Ouvrir la liste des instances

  2. Cliquez sur l'instance dont vous souhaitez consulter les tables.

  3. Cliquez sur Tables dans le volet de gauche.

    La page Tables affiche une liste des tables de l'instance.

  4. Cliquez sur Modifier pour la table que vous souhaitez modifier.

  5. Décochez la case Activer le stockage à plusieurs niveaux.

  6. Cliquez sur Enregistrer.

gcloud

Pour désactiver le stockage à accès peu fréquent, utilisez la commande gcloud beta bigtable instances tables update avec l'option --clear-tiered-storage-config :

gcloud beta bigtable instances tables update TABLE_ID \
    --instance=INSTANCE_ID \
    --project=PROJECT_ID \
    --clear-tiered-storage-config

Remplacez les éléments suivants :

  • TABLE_ID : ID de la table que vous souhaitez mettre à jour
  • INSTANCE_ID : ID de l'instance
  • PROJECT_ID : projet contenant la table que vous souhaitez mettre à jour

Étapes suivantes