Cette page a été traduite par l'API Cloud Translation.

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 en créer une, en modifier les options et en supprimer une. Pour savoir comment mettre à jour le schéma d'une 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 sur 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 avec dialecte GoogleSQL, vous pouvez définir la base de données schema soit lors de la création de la base de données, soit après la création de la base de données. Pour les bases de données en 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, qui est documenté pour GoogleSQL et PostgreSQL. Pour en savoir plus sur la création et la mise à jour de schémas, consultez les liens suivants :

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 de la base de données. Pour en savoir plus, consultez la section Empêcher la suppression accidentelle de bases de données.

Console

Dans la console Google Cloud, accédez à la page Instances Spanner.

Accéder à "Instances Spanner"
Sélectionnez l'instance dans laquelle créer la base de données.
Cliquez sur Créer une base de données.
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 de dialecte GoogleSQL, fournissez éventuellement un ensemble d'instructions LDD qui définir votre schéma. Utilisez les modèles de DDL pour préremplir les éléments courants. Si vos instructions DDL contiennent 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.
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, le 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 une réponse, 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, GOOGLE_STANDARD_SQL.
--ddl=DDL: Instructions DDL (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. En cas d'erreur 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. S'il y a une erreur dans une instruction, la base de données est n'a pas été créée. Si --ddl_file est défini, --ddl est ignoré. Non compatible avec les bases de données en dialecte PostgreSQL.

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

--kms-key=KMS_KEY: ID de la clé ou identifiant complet de la clé.
Cette option doit être spécifiée si l'un des autres arguments de cette sont spécifiés. 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 de 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 le service 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 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 "cloud.google.com/go/spanner/admin/database/apiv1/databasepb"
)

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 Bibliothèques clientes Spanner.


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);
    }
  }
}

Node.js

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

/**
 * 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();

PHP

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

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);
}

Python

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

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),
        )
    )

Ruby

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

# 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 la 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 DDL ALTER DATABASE pour GoogleSQL ou PostgreSQL.

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

Console

Accédez à la page Instances de la console Google Cloud.

Instances
Sélectionnez l'instance contenant la base de données à modifier.
Sélectionnez la base de données.
Cliquez sur Spanner Studio.
Cliquez sur Nouvel onglet ou utilisez le champ vide. de l'éditeur. Saisissez ensuite les instructions DDL à appliquer.
Cliquez sur Exécuter pour appliquer les mises à jour. S'il y a des erreurs dans votre LDD, la console Google Cloud renvoie une erreur et la base de données n'est pas modifiées.

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] \

Consultez la Documentation de référence sur gcloud pour des détails sur les options disponibles.

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

Reportez-vous à la documentation de référence sur le langage de définition de données ALTER DATABASE pour Google SQL ou PostgreSQL pour connaître les instructions de langage de définition de données à inclure.

LDD

Consultez la documentation de référence sur le LDD ALTER DATABASE pour GoogleSQL ou PostgreSQL pour plus de détails.

Vérifier l'avancement des opérations de mise à jour du schéma

Console

Dans le menu de navigation Spanner, sélectionnez l'onglet Opérations. La La page Opérations affiche la liste des opérations en cours d'exécution.
Recherchez l'opération de schéma dans la liste. Si l'opération est toujours en cours, la barre de progression de la colonne Heure de fin indique le pourcentage de l'opération terminée, comme illustré dans l'image suivante :

Capture d'écran de la barre de progression indiquant 98%

gcloud

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

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.

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 de l'opération c'est terminé. 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

Obtenez l'ID de l'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.
Vérifiez la progression de l'opération.

Avant d'utiliser les données de requête ci-dessous, 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 d'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. Base de données La suppression est irréversible. Si la protection contre la suppression des 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é protection contre la suppression.

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

Console

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

Instances
Sélectionnez l'instance contenant la base de données à supprimer.
Sélectionnez la base de données.
Cliquez sur Supprimer la base de données. Un message de confirmation s'affiche.
Saisissez le nom de la base de données, puis cliquez sur Supprimer.

gcloud

Pour supprimer une base de données avec 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 les Référence gcloud.

LDD

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

Étape suivante

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 éviter la suppression accidentelle de bases de données.
Découvrez comment mettre à jour un schéma.

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

Créer une base de données

Console

gcloud

Client (GoogleSQL)

C++

Go

Java

Node.js

PHP

Python

Ruby

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

GoogleSQL

PostgreSQL

GoogleSQL

PostgreSQL

Console

gcloud

LDD

Vérifier l'avancement des opérations de mise à jour du schéma

Console

gcloud

REST v1

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

Supprimer une base de données

Console

gcloud

LDD

Étape suivante