Créer et gérer des bases de données

Cette page explique comment gérer une base de données Spanner, y compris comment créer une base de données, modifier les options de base de données et supprimer une base de données. Pour savoir comment mettre à jour un schéma de base de données, consultez Effectuer des mises à jour de schéma.

Pour vous entraîner à créer une base de données et à la charger avec des exemples de données, consultez l'atelier de programmation Votre première base de données.

Créer une base de données

Les exemples suivants montrent comment créer une base de données dans une instance existante.

Pour les bases de données utilisant le dialecte GoogleSQL, vous pouvez définir le schéma de la base de données soit au moment de la création de la base de données, soit après sa création. Pour les bases de données de dialecte PostgreSQL, vous devez définir le schéma après la création.

Les schémas sont définis à l'aide du langage de définition de base de données, documenté pour GoogleSQL et PostgreSQL. Consultez les liens suivants pour en savoir plus sur la création et la mise à jour des schémas:

• Schéma et modèle de données
• Bonnes pratiques relatives à la conception de schémas
• Mises à jour des schémas

Une fois votre base de données créée, vous pouvez protéger les bases de données importantes pour vos applications et services en activant la protection contre la suppression des bases de données. Pour en savoir plus, consultez la section Empêcher la suppression accidentelle de bases de données.

Console

1. Accédez à la page Instances dans la console Google Cloud.

   Instances

2. Sélectionnez l'instance dans laquelle créer la base de données.

3. Cliquez sur Créer une base de données.

4. Saisissez les valeurs suivantes :

   • Un nom de base de données à afficher dans la console Google Cloud.
   • Dialecte à utiliser pour cette base de données.
   • Pour les bases de données à dialecte GoogleSQL, vous pouvez éventuellement fournir un ensemble d'instructions LDD qui définissent votre schéma. Utilisez les modèles LDD pour préremplir les éléments communs. Si vos instructions LDD comportent des erreurs, la console Google Cloud renvoie une erreur lorsque vous essayez de créer la base de données.
   • Si vous le souhaitez, sélectionnez une clé de chiffrement gérée par le client à utiliser pour cette base de données.

5. Cliquez sur Créer pour créer la base de données.

gcloud

Exécutez la commande gcloud spanner databases create.

gcloud spanner databases create DATABASE \
  --instance=INSTANCE \
  [--async] \
  [--database-dialect=DATABASE_DIALECT] \
  [--ddl=DDL] \
  [--ddl-file=DDL_FILE] \
  [--kms-key=KMS_KEY : --kms-keyring=KMS_KEYRING --kms-location=KMS_LOCATION --kms-project=KMS_PROJECT] \
  [GCLOUD_WIDE_FLAG …]

Les options suivantes sont requises :

DATABASE

ID de la base de données ou identifiant complet de la base de données. Si vous spécifiez l'identifiant complet, l'option --instance peut être omise.

--instance=INSTANCE

Instance Spanner de la base de données.

Les options suivantes sont facultatives :

--async

Renvoie immédiatement, sans attendre la fin de l'opération en cours.

--database-dialect=DATABASE_DIALECT

Dialecte SQL de la base de données Spanner. Doit être l'un des suivants: POSTGRESQL ou GOOGLE_STANDARD_SQL.

--ddl=DDL

Instructions LDD (langage de définition de données) séparées par un point-virgule à exécuter dans la base de données nouvellement créée. Si une erreur se produit dans une instruction, la base de données n'est pas créée. Cette option est ignorée si --ddl_file est défini. Non compatible avec les bases de données de dialecte PostgreSQL.

--ddl-file=DDL_FILE

Chemin d'accès d'un fichier contenant des instructions LDD (langage de définition de données) séparées par des points-virgules à exécuter dans la base de données nouvellement créée. Si une erreur se produit dans une instruction, la base de données n'est pas créée. Si --ddl_file est défini, --ddl est ignoré. Non compatible avec les bases de données de dialecte PostgreSQL.

Si vous spécifiez une clé Cloud Key Management Service à utiliser lors de la création de la base de données, incluez les options suivantes:

--kms-key=KMS_KEY

ID ou identifiant complet de la clé.

Cette option doit être spécifiée si l'un des autres arguments de ce groupe est spécifié. Les autres arguments peuvent être omis si l'identifiant complet est fourni.

--kms-keyring=KMS_KEYRING

ID du trousseau de clés Cloud KMS de la clé.

--kms-location=KMS_LOCATION

Emplacement Google Cloud de la clé.

--kms-project=KMS_PROJECT

ID de projet Google Cloud pour la clé.

Client (GoogleSQL)

C++

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

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

void CreateDatabase(google::cloud::spanner_admin::DatabaseAdminClient client,
                    std::string const& project_id,
                    std::string const& instance_id,
                    std::string const& database_id) {
  google::cloud::spanner::Database database(project_id, instance_id,
                                            database_id);
  google::spanner::admin::database::v1::CreateDatabaseRequest request;
  request.set_parent(database.instance().FullName());
  request.set_create_statement("CREATE DATABASE `" + database.database_id() +
                               "`");
  request.add_extra_statements(R"""(
      CREATE TABLE Singers (
          SingerId   INT64 NOT NULL,
          FirstName  STRING(1024),
          LastName   STRING(1024),
          SingerInfo BYTES(MAX),
          FullName   STRING(2049)
              AS (ARRAY_TO_STRING([FirstName, LastName], " ")) STORED
      ) PRIMARY KEY (SingerId))""");
  request.add_extra_statements(R"""(
      CREATE TABLE Albums (
          SingerId     INT64 NOT NULL,
          AlbumId      INT64 NOT NULL,
          AlbumTitle   STRING(MAX)
      ) PRIMARY KEY (SingerId, AlbumId),
          INTERLEAVE IN PARENT Singers ON DELETE CASCADE)""");
  auto db = client.CreateDatabase(request).get();
  if (!db) throw std::move(db).status();
  std::cout << "Database " << db->name() << " created.\n";
}

Go

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

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

import (
	"context"
	"fmt"
	"io"
	"regexp"

	database "cloud.google.com/go/spanner/admin/database/apiv1"
	adminpb "google.golang.org/genproto/googleapis/spanner/admin/database/v1"
)

func createDatabase(ctx context.Context, w io.Writer, db string) error {
	matches := regexp.MustCompile("^(.*)/databases/(.*)$").FindStringSubmatch(db)
	if matches == nil || len(matches) != 3 {
		return fmt.Errorf("Invalid database id %s", db)
	}

	adminClient, err := database.NewDatabaseAdminClient(ctx)
	if err != nil {
		return err
	}
	defer adminClient.Close()

	op, err := adminClient.CreateDatabase(ctx, &adminpb.CreateDatabaseRequest{
		Parent:          matches[1],
		CreateStatement: "CREATE DATABASE `" + matches[2] + "`",
		ExtraStatements: []string{
			`CREATE TABLE Singers (
				SingerId   INT64 NOT NULL,
				FirstName  STRING(1024),
				LastName   STRING(1024),
				SingerInfo BYTES(MAX),
				FullName   STRING(2048) AS (
					ARRAY_TO_STRING([FirstName, LastName], " ")
				) STORED
			) PRIMARY KEY (SingerId)`,
			`CREATE TABLE Albums (
				SingerId     INT64 NOT NULL,
				AlbumId      INT64 NOT NULL,
				AlbumTitle   STRING(MAX)
			) PRIMARY KEY (SingerId, AlbumId),
			INTERLEAVE IN PARENT Singers ON DELETE CASCADE`,
		},
	})
	if err != nil {
		return err
	}
	if _, err := op.Wait(ctx); err != nil {
		return err
	}
	fmt.Fprintf(w, "Created database [%s]\n", db)
	return nil
}

Java

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

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

import com.google.cloud.spanner.SpannerException;
import com.google.cloud.spanner.SpannerExceptionFactory;
import com.google.cloud.spanner.admin.database.v1.DatabaseAdminClient;
import com.google.common.collect.ImmutableList;
import com.google.spanner.admin.database.v1.CreateDatabaseRequest;
import com.google.spanner.admin.database.v1.Database;
import java.io.IOException;
import java.util.concurrent.ExecutionException;

public class CreateDatabaseWithDefaultLeaderSample {

  static void createDatabaseWithDefaultLeader() throws IOException {
    // TODO(developer): Replace these variables before running the sample.
    final String instanceName = "projects/my-project/instances/my-instance-id";
    final String databaseId = "my-database-name";
    final String defaultLeader = "my-default-leader";
    createDatabaseWithDefaultLeader(instanceName, databaseId, defaultLeader);
  }

  static void createDatabaseWithDefaultLeader(String instanceName, String databaseId,
      String defaultLeader) throws IOException {
    try (DatabaseAdminClient databaseAdminClient = DatabaseAdminClient.create()) {
      Database createdDatabase =
          databaseAdminClient.createDatabaseAsync(
              CreateDatabaseRequest.newBuilder()
                  .setParent(instanceName)
                  .setCreateStatement("CREATE DATABASE `" + databaseId + "`")
                  .addAllExtraStatements(
                      ImmutableList.of("CREATE TABLE Singers ("
                              + "  SingerId   INT64 NOT NULL,"
                              + "  FirstName  STRING(1024),"
                              + "  LastName   STRING(1024),"
                              + "  SingerInfo BYTES(MAX)"
                              + ") PRIMARY KEY (SingerId)",
                          "CREATE TABLE Albums ("
                              + "  SingerId     INT64 NOT NULL,"
                              + "  AlbumId      INT64 NOT NULL,"
                              + "  AlbumTitle   STRING(MAX)"
                              + ") PRIMARY KEY (SingerId, AlbumId),"
                              + "  INTERLEAVE IN PARENT Singers ON DELETE CASCADE",
                          "ALTER DATABASE " + "`" + databaseId + "`"
                              + " SET OPTIONS ( default_leader = '" + defaultLeader + "' )"))
                  .build()).get();
      System.out.println("Created database [" + createdDatabase.getName() + "]");
      System.out.println("\tDefault leader: " + createdDatabase.getDefaultLeader());
    } catch (ExecutionException e) {
      // If the operation failed during execution, expose the cause.
      throw (SpannerException) e.getCause();
    } catch (InterruptedException e) {
      // Throw when a thread is waiting, sleeping, or otherwise occupied,
      // and the thread is interrupted, either before or during the activity.
      throw SpannerExceptionFactory.propagateInterrupt(e);
    }
  }
}

Remarque:Les exemples de code de l'ancienne interface de la bibliothèque cliente pour Java sont archivés dans GitHub.

Node.js

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

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

/**
 * TODO(developer): Uncomment the following lines before running the sample.
 */
// const projectId = 'my-project-id';
// const instanceId = 'my-instance-id';
// const databaseId = 'my-database-id';
// const defaultLeader = 'my-default-leader'; example: 'asia-northeast1'

// Imports the Google Cloud client library
const {Spanner} = require('@google-cloud/spanner');

// creates a client
const spanner = new Spanner({
  projectId: projectId,
});

// Gets a reference to a Cloud Spanner Database Admin Client object
const databaseAdminClient = spanner.getDatabaseAdminClient();

async function createDatabaseWithDefaultLeader() {
  // Create a new database with an extra statement which will alter the
  // database after creation to set the default leader.
  console.log(
    `Creating database ${databaseAdminClient.databasePath(
      projectId,
      instanceId,
      databaseId
    )}.`
  );
  const createSingersTableStatement = `
    CREATE TABLE Singers (
      SingerId   INT64 NOT NULL,
      FirstName  STRING(1024),
      LastName   STRING(1024),
      SingerInfo BYTES(MAX)
    ) PRIMARY KEY (SingerId)`;
  const createAlbumsStatement = `
    CREATE TABLE Albums (
      SingerId     INT64 NOT NULL,
      AlbumId      INT64 NOT NULL,
      AlbumTitle   STRING(MAX)
    ) PRIMARY KEY (SingerId, AlbumId),
      INTERLEAVE IN PARENT Singers ON DELETE CASCADE`;

  // Default leader is one of the possible values in the leaderOptions field of the
  // instance config of the instance where the database is created.
  const setDefaultLeaderStatement = `
    ALTER DATABASE \`${databaseId}\`
    SET OPTIONS (default_leader = '${defaultLeader}')`;

  const [operation] = await databaseAdminClient.createDatabase({
    createStatement: 'CREATE DATABASE `' + databaseId + '`',
    extraStatements: [
      createSingersTableStatement,
      createAlbumsStatement,
      setDefaultLeaderStatement,
    ],
    parent: databaseAdminClient.instancePath(projectId, instanceId),
  });

  console.log(`Waiting for creation of ${databaseId} to complete...`);
  await operation.promise();
  console.log(
    `Created database ${databaseId} with default leader ${defaultLeader}.`
  );
}
createDatabaseWithDefaultLeader();

Remarque:Les exemples de code de l'ancienne interface de la bibliothèque cliente pour Node.js sont archivés dans GitHub.

PHP

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

Pour vous authentifier auprès de Spanner, 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\Spanner\Admin\Database\V1\Client\DatabaseAdminClient;
use Google\Cloud\Spanner\Admin\Database\V1\CreateDatabaseRequest;

/**
 * Creates a database and tables for sample data.
 * Example:
 * ```
 * create_database($instanceId, $databaseId);
 * ```
 *
 * @param string $projectId The Google Cloud project ID.
 * @param string $instanceId The Spanner instance ID.
 * @param string $databaseId The Spanner database ID.
 */
function create_database(string $projectId, string $instanceId, string $databaseId): void
{
    $databaseAdminClient = new DatabaseAdminClient();
    $instance = $databaseAdminClient->instanceName($projectId, $instanceId);

    $operation = $databaseAdminClient->createDatabase(
        new CreateDatabaseRequest([
            'parent' => $instance,
            'create_statement' => sprintf('CREATE DATABASE `%s`', $databaseId),
            'extra_statements' => [
                'CREATE TABLE Singers (' .
                'SingerId     INT64 NOT NULL,' .
                'FirstName    STRING(1024),' .
                'LastName     STRING(1024),' .
                'SingerInfo   BYTES(MAX),' .
                'FullName     STRING(2048) AS' .
                '(ARRAY_TO_STRING([FirstName, LastName], " ")) STORED' .
                ') PRIMARY KEY (SingerId)',
                'CREATE TABLE Albums (' .
                    'SingerId     INT64 NOT NULL,' .
                    'AlbumId      INT64 NOT NULL,' .
                    'AlbumTitle   STRING(MAX)' .
                ') PRIMARY KEY (SingerId, AlbumId),' .
                'INTERLEAVE IN PARENT Singers ON DELETE CASCADE'
            ]
        ])
    );

    print('Waiting for operation to complete...' . PHP_EOL);
    $operation->pollUntilComplete();

    printf('Created database %s on instance %s' . PHP_EOL,
        $databaseId, $instanceId);
}

Remarque:Les exemples de code de l'ancienne interface de la bibliothèque cliente pour PHP sont archivés dans GitHub.

Python

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

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

def create_database(instance_id, database_id):
    """Creates a database and tables for sample data."""
    from google.cloud.spanner_admin_database_v1.types import \
        spanner_database_admin

    spanner_client = spanner.Client()
    database_admin_api = spanner_client.database_admin_api

    request = spanner_database_admin.CreateDatabaseRequest(
        parent=database_admin_api.instance_path(spanner_client.project, instance_id),
        create_statement=f"CREATE DATABASE `{database_id}`",
        extra_statements=[
            """CREATE TABLE Singers (
            SingerId     INT64 NOT NULL,
            FirstName    STRING(1024),
            LastName     STRING(1024),
            SingerInfo   BYTES(MAX),
            FullName   STRING(2048) AS (
                ARRAY_TO_STRING([FirstName, LastName], " ")
            ) STORED
        ) PRIMARY KEY (SingerId)""",
            """CREATE TABLE Albums (
            SingerId     INT64 NOT NULL,
            AlbumId      INT64 NOT NULL,
            AlbumTitle   STRING(MAX)
        ) PRIMARY KEY (SingerId, AlbumId),
        INTERLEAVE IN PARENT Singers ON DELETE CASCADE""",
        ],
    )

    operation = database_admin_api.create_database(request=request)

    print("Waiting for operation to complete...")
    database = operation.result(OPERATION_TIMEOUT_SECONDS)

    print(
        "Created database {} on instance {}".format(
            database.name,
            database_admin_api.instance_path(spanner_client.project, instance_id),
        )
    )

Remarque:Les exemples de code de l'ancienne interface de la bibliothèque cliente pour Python sont archivés dans GitHub.

Ruby

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

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

# project_id  = "Your Google Cloud project ID"
# instance_id = "Your Spanner instance ID"
# database_id = "Your Spanner database ID"

require "google/cloud/spanner"
require "google/cloud/spanner/admin/database"

database_admin_client = Google::Cloud::Spanner::Admin::Database.database_admin

instance_path = database_admin_client.instance_path project: project_id, instance: instance_id

job = database_admin_client.create_database parent: instance_path,
                                            create_statement: "CREATE DATABASE `#{database_id}`",
                                            extra_statements: [
                                              "CREATE TABLE Singers (
      SingerId     INT64 NOT NULL,
      FirstName    STRING(1024),
      LastName     STRING(1024),
      SingerInfo   BYTES(MAX)
    ) PRIMARY KEY (SingerId)",

                                              "CREATE TABLE Albums (
      SingerId     INT64 NOT NULL,
      AlbumId      INT64 NOT NULL,
      AlbumTitle   STRING(MAX)
    ) PRIMARY KEY (SingerId, AlbumId),
    INTERLEAVE IN PARENT Singers ON DELETE CASCADE"
                                            ]

puts "Waiting for create database operation to complete"

job.wait_until_done!

puts "Created database #{database_id} on instance #{instance_id}"

Mettre à jour le schéma ou les options de base de données

Vous pouvez mettre à jour le schéma et les options de votre base de données à l'aide d'instructions LDD.

Par exemple, pour ajouter une colonne à une table, utilisez l'instruction LDD suivante:

GoogleSQL

ALTER TABLE Songwriters ADD COLUMN Publisher STRING(10);

PostgreSQL

ALTER TABLE Songwriters ADD COLUMN Publisher VARCHAR(10);

Pour mettre à jour la version de l'optimiseur de requêtes, utilisez l'instruction LDD suivante:

GoogleSQL

ALTER DATABASE Music SET OPTIONS(optimizer_version=null);

PostgreSQL

ALTER DATABASE DB-NAME SET spanner.optimizer_version TO DEFAULT;

Pour en savoir plus sur les options compatibles, consultez la documentation de référence sur le LDD ALTER DATABASE pour GoogleSQL ou PostgreSQL.

Pour en savoir plus sur les mises à jour de schéma, consultez Effectuer des mises à jour de schéma.

Console

1. Accédez à la page Instances dans la console Google Cloud.

   Instances

2. Sélectionnez l'instance contenant la base de données à modifier.

3. Sélectionnez la base de données.

4. Cliquez sur Spanner Studio.

5. Cliquez sur Nouvel onglet ou utilisez l'onglet vide de l'éditeur. Ensuite, saisissez les instructions LDD à appliquer.

6. Cliquez sur Exécuter pour appliquer les mises à jour. Si votre LDD comporte des erreurs, la console Google Cloud renvoie une erreur et la base de données n'est pas modifiée.

gcloud

Pour modifier une base de données à l'aide de l'outil de ligne de commande gcloud, utilisez gcloud spanner databases ddl update.

gcloud spanner databases ddl update \
(DATABASE : --instance=INSTANCE) \
[--async] \
[--ddl=DDL] \
[--ddl-file=DDL_FILE] \

Pour en savoir plus sur les options disponibles, consultez la documentation de référence sur gcloud.

Transmettez les mises à jour de la base de données à la commande avec l'option --ddl ou --ddl-file. Si un fichier LDD est spécifié, l'option --ddl est ignorée.

Reportez-vous à la documentation de référence sur le LDD ALTER DATABASE pour GoogleSQL ou PostgreSQL afin d'inclure les instructions LDD.

LDD

Pour en savoir plus, consultez la documentation de référence sur le LDD ALTER DATABASE pour GoogleSQL ou PostgreSQL.

Vérifier la progression des opérations de mise à jour du schéma

Console

1. Dans le menu de navigation de Spanner, sélectionnez l'onglet Opérations. La page Opérations affiche la liste des opérations en cours d'exécution.

2. Recherchez l'opération de schéma dans la liste. Si elle est toujours en cours d'exécution, la barre de progression de la colonne End time (Heure de fin) affiche le pourcentage de l'opération terminée, comme illustré dans l'image suivante:

gcloud

Utilisez gcloud spanner operations describe pour vérifier la progression d'une opération.

1. Obtenez l'ID d'opération:

   gcloud spanner operations list --instance=INSTANCE-NAME \
   --database=DATABASE-NAME --type=DATABASE_UPDATE_DDL
   

   Remplacez les éléments suivants :

   • INSTANCE-NAME par le nom de l'instance Spanner.
   • DATABASE-NAME par le nom de la base de données.

2. Exécutez gcloud spanner operations describe :

   gcloud spanner operations describe OPERATION_ID\
   --instance=INSTANCE-NAME \
   --database=DATABASE-NAME
   

   Remplacez les éléments suivants :

   • OPERATION-ID: ID de l'opération que vous souhaitez vérifier.
   • INSTANCE-NAME: nom de l'instance Spanner.
   • DATABASE-NAME: nom de la base de données Spanner.

   La section progress du résultat indique le pourcentage d'achèvement de l'opération. La sortie ressemble à ceci :

   done: true
   metadata:
   ...
     progress:
     - endTime: '2022-03-01T00:28:06.691403Z'
       progressPercent: 100
       startTime: '2022-03-01T00:28:04.221401Z'
     - endTime: '2022-03-01T00:28:17.624588Z'
       startTime: '2022-03-01T00:28:06.691403Z'
       progressPercent: 100
   ...
   

REST v1

1. Obtenez l'ID d'opération:

   gcloud spanner operations list --instance=INSTANCE-NAME \
   --database=DATABASE-NAME --type=DATABASE_UPDATE_DDL
   

   Remplacez les éléments suivants :

   • INSTANCE-NAME par le nom de l'instance Spanner.
   • DATABASE-NAME par le nom de la base de données.

2. Vérifiez la progression de l'opération.

   Avant d'utiliser les données de requête, effectuez les remplacements suivants:

   • PROJECT-ID : ID du projet.
   • INSTANCE-ID : ID de l'instance.
   • DATABASE-ID: ID de la base de données.
   • OPERATION-ID: ID de l'opération.

   Méthode HTTP et URL :

   GET https://spanner.googleapis.com/v1/projects/PROJECT-ID/instances/INSTANCE-ID/databases/DATABASE-ID/operations/OPERATION-ID

   Pour envoyer votre requête, développez l'une des options suivantes :

   curl (Linux, macOS ou Cloud Shell)

   Remarque : La commande suivante suppose que vous êtes connecté à la CLI gcloud avec votre compte utilisateur en exécutant la commande gcloud init ou gcloud auth login, ou en utilisant Cloud Shell, qui vous connecte automatiquement à la CLI gcloud. Vous pouvez exécuter la commande gcloud auth list pour vérifier quel est le compte actuellement actif.

   exécutez la commande suivante :

   curl -X GET \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        "https://spanner.googleapis.com/v1/projects/PROJECT-ID/instances/INSTANCE-ID/databases/DATABASE-ID/operations/OPERATION-ID"

   PowerShell (Windows)

   Remarque : La commande suivante suppose que vous vous êtes connecté à la CLI gcloud avec votre compte utilisateur en exécutant la commande gcloud init ou gcloud auth login. Vous pouvez exécuter la commande gcloud auth list pour vérifier quel est le compte actuellement actif.

   exécutez la commande suivante :

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method GET `
       -Headers $headers `
       -Uri "https://spanner.googleapis.com/v1/projects/PROJECT-ID/instances/INSTANCE-ID/databases/DATABASE-ID/operations/OPERATION-ID" | Select-Object -Expand Content

   Vous devriez recevoir une réponse JSON de ce type :

   {
   ...
       "progress": [
         {
           "progressPercent": 100,
           "startTime": "2023-05-27T00:52:27.366688Z",
           "endTime": "2023-05-27T00:52:30.184845Z"
         },
         {
           "progressPercent": 100,
           "startTime": "2023-05-27T00:52:30.184845Z",
           "endTime": "2023-05-27T00:52:40.750959Z"
         }
       ],
   ...
     "done": true,
     "response": {
       "@type": "type.googleapis.com/google.protobuf.Empty"
     }
   }
   
   

Si l'opération prend trop de temps, vous pouvez l'annuler. Pour en savoir plus, consultez la section Annuler une opération de base de données de longue durée.

Supprimer une base de données

La suppression d'une base de données est définitive. Toutes ses données sont alors supprimées. La suppression de la base de données est irréversible. Si la protection contre la suppression de bases de données est activée sur une base de données, vous ne pouvez pas la supprimer tant que vous n'avez pas désactivé cette protection.

Les sauvegardes existantes ne sont pas supprimées en cas de suppression d'une base de données. Pour en savoir plus, consultez la section Sauvegarde et restauration.

Console

1. Accédez à la page Instances dans la console Google Cloud.

   Instances

2. Sélectionnez l'instance contenant la base de données à supprimer.

3. Sélectionnez la base de données.

4. Cliquez sur Supprimer la base de données. Une confirmation s'affiche.

5. Saisissez le nom de la base de données, puis cliquez sur Supprimer.

gcloud

Pour supprimer une base de données à l'aide de l'outil de ligne de commande gcloud, utilisez gcloud spanner databases delete.

gcloud spanner databases delete \
  (DATABASE : --instance=INSTANCE)

Les options suivantes sont requises :

DATABASE

ID de la base de données ou identifiant complet de la base de données. Si l'identifiant complet est fourni, l'option --instance doit être omise.

--instance=INSTANCE

Instance Spanner de la base de données.

Pour en savoir plus, consultez la documentation de référence sur gcloud.

LDD

Le LDD n'est pas compatible avec la syntaxe de suppression de base de données.

Étapes suivantes

• Créez une base de données et chargez-la avec des exemples de données.
• Obtenez plus d'informations sur la documentation de référence sur le LDD GoogleSQL.
• En savoir plus sur la documentation de référence sur le LDD PostgreSQL
• Découvrez comment sauvegarder et restaurer une base de données.
• Découvrez comment empêcher la suppression accidentelle de bases de données.
• Découvrez comment effectuer des mises à jour de schéma.