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

Cette page explique comment gérer une instance Spanner database, 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 la Votre premier atelier de programmation sur la 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 sa 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. Consultez les liens suivants pour plus d'informations 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

Après avoir créé votre base de données, vous pouvez sauvegarder les bases de données importantes à vos applications et services en activant la protection contre la suppression de bases de données. Pour 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 de dialecte GoogleSQL, fournissez éventuellement un ensemble d'instructions LDD qui définir votre schéma. Utilisez les Modèles LDD pour préremplir les éléments communs S'il y a des erreurs dans instructions LDD, la console Google Cloud renvoie une erreur 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 du 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

Retour immédiat, sans attendre l'opération en cours pour terminer.

--database-dialect=DATABASE_DIALECT

Dialecte SQL de la base de données Spanner. Doit être au choix: 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 nouvelle base de données. Si une erreur se produit dans une , la base de données n'est pas créée. Cet indicateur est ignoré 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 éléments séparés par un point-virgule des instructions LDD (langage de définition de données) à exécuter dans le nouvel la base de données 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 sont ignorées. Non compatible avec les bases de données de 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 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 la méthode 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 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 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 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);
    }
  }
}

<ph type="x-smartling-placeholder">

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

<ph type="x-smartling-placeholder">

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

<ph type="x-smartling-placeholder">

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

<ph type="x-smartling-placeholder">

</ph> 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 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, reportez-vous au LDD ALTER DATABASE référence pour GoogleSQL ou PostgreSQL.

Pour en savoir plus sur les mises à jour de schéma, consultez Effectuez 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 le champ vide. de l'éditeur. Ensuite, saisissez les instructions LDD à appliquer.

6. 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 le 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'option --ddl ou --ddl-file. Si un fichier LDD est spécifié, l'option --ddl est ignorée.

Consultez la documentation de référence sur le LDD ALTER DATABASE pour GoogleSQL ou PostgreSQL pour que les instructions LDD à 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 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 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. S'il est toujours en cours d'exécution, l'état la barre de la colonne End time (Heure de fin) indique le pourcentage de l'opération qui est terminée, comme illustré dans l'image suivante:

gcloud

Utiliser 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 l'instance Spanner. son nom.
   • 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 effectuer. 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

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 l'instance Spanner. son nom.
   • 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 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 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 Annulez 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

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, exécutez la commande suivante : 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, le --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 empêcher la suppression accidentelle de bases de données.
• Découvrez comment effectuer des mises à jour de schéma.