Crea y administra bases de datos

En esta página, se describe cómo crear y administrar bases de datos de Spanner:

• Varios métodos para crear una base de datos
• Cómo modificar las opciones de la base de datos
• Borrar una base de datos

En esta página, se incluye información para las bases de datos con dialecto de GoogleSQL y las bases de datos con dialecto de PostgreSQL. Para obtener información sobre cómo actualizar un esquema de base de datos, consulta Realizar actualizaciones de esquema. Para obtener más información sobre cómo crear una instancia, consulta Crea y administra instancias. Puedes crear una base de datos en una instancia existente de cualquiera de las siguientes maneras:

• Crear una base de datos: Puedes crear una base de datos nueva seleccionando el dialecto de SQL y definiendo tu esquema.
• Importa tus propios datos: Puedes importar un archivo CSV, un volcado de MySQL o un volcado de PostgreSQL en una base de datos nueva o existente.
• Crea una base de datos con datos de muestra: Puedes completar una base de datos con uno de los conjuntos de datos de muestra disponibles para probar las capacidades de Spanner.

Crea una base de datos

Puedes crear una base de datos nueva en una instancia existente. En el caso de las bases de datos con dialecto de GoogleSQL, puedes definir el esquema de la base de datos en el momento de la creación o después de que se haya creado. En el caso de las bases de datos con dialecto de PostgreSQL, debes definir el esquema después de la creación.

Los esquemas se definen con el lenguaje de definición de bases de datos, que se documenta para GoogleSQL y PostgreSQL. Consulta los siguientes vínculos para obtener más información sobre cómo crear y actualizar esquemas:

• Esquema y modelo de datos
• Prácticas recomendadas sobre el diseño del esquema
• Actualizaciones del esquema

Después de crear tu base de datos, puedes proteger las bases de datos que son importantes para tus aplicaciones y servicios habilitando la protección contra la eliminación de bases de datos. Para obtener más información, consulta Cómo evitar la eliminación accidental de bases de datos.

Consola de Google Cloud

1. En la consola de Google Cloud , ve a la página Instancias de Spanner.

   Ir a Instancias de Spanner

2. Selecciona la instancia en la que se creará la base de datos.

3. Haz clic en Crear base de datos.

4. Ingresa los siguientes valores:

   • Un nombre de base de datos para mostrar en la consola de Google Cloud
   • El dialecto que se usará para esta base de datos.
   • Para las bases de datos con dialecto de GoogleSQL, proporciona de forma opcional un conjunto de instrucciones DDL que definan tu esquema. Usa las plantillas de DDL para completar previamente los elementos comunes. Si hay errores en tus instrucciones DDL, la consola de Google Cloud muestra un error cuando intentas crear la base de datos.
   • De manera opcional, selecciona una clave de encriptación administrada por el cliente para usar en esta base de datos.

5. Haz clic en Crear para crear la base de datos.

gcloud

Usa el comando gcloud spanner databases create.

```sh
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 …]
```

Se requieren las siguientes opciones:

DATABASE

: Es el ID de la base de datos o el identificador completamente calificado de la base de datos. Si especificas el identificador completamente calificado, se puede omitir la marca --instance.

--instance=INSTANCE

Instancia de Spanner para la base de datos.

Las siguientes configuraciones son opcionales:

--async

Se muestra de inmediato, sin necesidad de esperar a que se complete la operación en curso.

--database-dialect=DATABASE_DIALECT

Dialecto SQL de la base de datos de Spanner. Debe ser uno de los siguientes: POSTGRESQL, GOOGLE_STANDARD_SQL.

--ddl=DDL

Sentencias DDL (lenguaje de definición de datos) separadas por punto y coma para ejecutar dentro de la base de datos recién creada. Si hay un error en alguna instrucción, no se creará la base de datos. Esta marca se ignora si se configura --ddl_file. No es compatible con las bases de datos de dialecto PostgreSQL.

--ddl-file=DDL_FILE

Es la ruta de acceso a un archivo que contiene instrucciones DDL (lenguaje de definición de datos) separadas por punto y coma para ejecutar dentro de la base de datos recién creada. Si hay un error en alguna instrucción, no se crea la base de datos. Si se establece --ddl_file, se ignora --ddl. No es compatible con las bases de datos de dialecto PostgreSQL.

Si especificas una clave de Cloud Key Management Service para usar cuando crees la base de datos, incluye las siguientes opciones:

--kms-key=KMS_KEY

ID de la clave o identificador completamente calificado de la clave.

Esta marca se debe especificar si se especifica alguno de los otros argumentos de este grupo. Los otros argumentos se pueden omitir si se proporciona el identificador completamente calificado.

--kms-keyring=KMS_KEYRING

ID del llavero de claves de Cloud KMS de la clave.

--kms-location=KMS_LOCATION

Google Cloud ubicación de la llave.

--kms-project=KMS_PROJECT

Google Cloud ID del proyecto de la clave.

Cliente (GoogleSQL)

C++

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Spanner, consulta las bibliotecas cliente de Spanner.

Para autenticarte en Spanner, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo 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

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Spanner, consulta las bibliotecas cliente de Spanner.

Para autenticarte en Spanner, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo 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

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Spanner, consulta las bibliotecas cliente de Spanner.

Para autenticarte en Spanner, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo 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);
    }
  }
}

Nota: Los ejemplos de código de la interfaz de la biblioteca cliente anterior para Java se archivaron en GitHub.

Node.js

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Spanner, consulta las bibliotecas cliente de Spanner.

Para autenticarte en Spanner, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo 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();

Nota: Los ejemplos de código de la interfaz de la biblioteca cliente anterior para Node.js se archivaron en GitHub.

PHP

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Spanner, consulta las bibliotecas cliente de Spanner.

Para autenticarte en Spanner, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo 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);
}

Nota: Los ejemplos de código de la interfaz de la biblioteca cliente anterior para PHP se archivaron en GitHub.

Python

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Spanner, consulta las bibliotecas cliente de Spanner.

Para autenticarte en Spanner, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo 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),
        )
    )

Nota: Las muestras de código de la interfaz de la biblioteca cliente anterior para Python se archivaron en GitHub.

Ruby

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Spanner, consulta las bibliotecas cliente de Spanner.

Para autenticarte en Spanner, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo 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}"

Importación de tus propios datos

Puedes importar tus propios datos a una base de datos de Spanner con un archivo CSV, un archivo de volcado de MySQL o un archivo de volcado de PostgreSQL. Puedes subir un archivo local con Cloud Storage o directamente desde un bucket de Cloud Storage. Es posible que se apliquen cargos por subir un archivo local con Cloud Storage.

Si eliges usar un archivo CSV, también deberás subir un archivo JSON independiente que contenga el esquema de la base de datos.

Consola de Google Cloud

1. En la consola de Google Cloud , ve a la página Instancias de Spanner.

   Ir a Instancias de Spanner

2. Selecciona la instancia en la que se creará la base de datos.

3. Haz clic en Importar mis propios datos.

4. Ingresa los siguientes valores:

   • Selecciona el Tipo de archivo.

   • Sube el archivo desde tu computadora o selecciona una ruta de acceso al archivo en un bucket de Cloud Storage.

   • (Opcional) Si eliges usar un archivo CSV, también debes subir un archivo JSON independiente que contenga el esquema de la base de datos. El archivo JSON debe usar la siguiente estructura para definir el esquema:

     {
       "name": "COLUMN_NAME",
       "type": "TYPE",
       "notNull": NOT_NULL_VALUE,
       "primaryKeyOrder": PRIMARY_KEY_ORDER
     }

     Reemplaza lo siguiente:

     • COLUMN_NAME: Es el nombre de la columna en la tabla.

     • TYPE: Es el tipo de datos de la columna.

     • NOT_NULL_VALUE (opcional): Indica si la columna puede almacenar valores nulos o no. Las entradas válidas son true o false. La configuración predeterminada es false.

     • (Opcional): PRIMARY_KEY_ORDER: Determina el orden de la clave primaria. El valor se establece en 0 para una columna de clave no principal. Establece el valor en un número entero, por ejemplo, 1 para una columna de clave primaria. Las columnas con números más bajos aparecen antes en una clave primaria compuesta.

     De forma predeterminada, el archivo CSV espera una coma como delimitador de campo y una línea nueva como delimitador de línea. Para obtener más información sobre el uso de delimitadores personalizados, consulta la referencia de gcloud alpha spanner databases import.

   • Selecciona una base de datos nueva o existente como destino.

5. Haz clic en Importar.

6. Spanner abre Cloud Shell y completa un comando que instala la herramienta de migración de Spanner y ejecuta el comando gcloud alpha spanner databases import. Presiona la tecla ENTER para importar datos a tu base de datos.

Usa un conjunto de datos de muestra

Puedes completar bases de datos nuevas en una instancia existente a partir de conjuntos de datos de muestra que te ayudan a explorar las capacidades de Spanner, como su modelo relacional, la búsqueda de texto completo o la búsqueda de vectores.

Consola de Google Cloud

1. En la consola de Google Cloud , ve a la página Instancias de Spanner.

   Ir a Instancias de Spanner

2. Selecciona la instancia en la que se creará la base de datos.

3. Haz clic en Explorar conjuntos de datos.

4. Selecciona uno de los siguientes conjuntos de datos:

   • Gráfico de finanzas: Usa este conjunto de datos para explorar las funciones de gráficos de Spanner.
   • Banca en línea: Usa este conjunto de datos para explorar las funciones de búsqueda en el texto completo de Spanner.
   • Juegos en línea: Usa este conjunto de datos para explorar las funciones de la base de datos relacional de Spanner.
   • Venta minorista: Usa este conjunto de datos para explorar las funciones de gráficos y de búsqueda en el texto completo de Spanner.

5. Haz clic en Crear base de datos.

Actualiza el esquema o las opciones de la base de datos

Puedes actualizar el esquema y las opciones de tu base de datos con instrucciones DDL.

Por ejemplo, para agregar una columna a una tabla, usa la siguiente instrucción DDL:

GoogleSQL

ALTER TABLE Songwriters ADD COLUMN Publisher STRING(10);

PostgreSQL

ALTER TABLE Songwriters ADD COLUMN Publisher VARCHAR(10);

Para actualizar la versión del optimizador de consultas, usa la siguiente instrucción DDL:

GoogleSQL

ALTER DATABASE Music SET OPTIONS(optimizer_version=null);

PostgreSQL

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

Para obtener más información sobre las opciones admitidas, consulta la referencia de DDL de ALTER DATABASE para GoogleSQL o PostgreSQL.

Para obtener información sobre las actualizaciones del esquema, consulta Realiza actualizaciones de esquema.

Consola de Google Cloud

1. En la consola de Google Cloud , ve a la página Instancias de Spanner.

   Ir a Instancias de Spanner

2. Selecciona la instancia que contiene la base de datos que deseas modificar.

3. Selecciona la base de datos.

4. Haz clic en Spanner Studio.

5. Haz clic en Pestaña nueva o usa la pestaña del editor vacía. Luego, ingresa las instrucciones DDL que se aplicarán.

6. Haz clic en Ejecutar para aplicar las actualizaciones. Si hay errores en tu DDL, la consola Google Cloud devuelve un error y no se altera la base de datos.

gcloud

Para modificar una base de datos con la herramienta de línea de comandos gcloud, usa gcloud spanner databases ddl update.

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

Consulta la referencia de gcloud para obtener detalles sobre las opciones disponibles.

Pasa las actualizaciones de la base de datos al comando con la marca --ddl o la marca --ddl-file. Si se especifica un archivo DDL, se ignora la marca --ddl.

Consulta la ALTER DATABASE referencia de DDL para GoogleSQL o PostgreSQL para conocer las instrucciones DDL que se deben incluir.

DDL

Consulta la referencia de DDL de ALTER DATABASE para obtener detalles sobre GoogleSQL o PostgreSQL.

Cómo verificar el progreso de las operaciones de actualización del esquema

Consola de Google Cloud

1. En el menú de navegación de Spanner, selecciona la pestaña Operaciones. En la página Operaciones, se muestra una lista de las operaciones en ejecución activas.

2. Busca la operación de esquema en la lista. Si aún se está ejecutando, la barra de progreso de la columna Hora de finalización muestra el porcentaje de la operación que se completó, como se muestra en la siguiente imagen:

gcloud

Usa gcloud spanner operations describe para verificar el progreso de una operación.

1. Obtén el ID de operación:

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

   Reemplaza lo siguiente:

   • INSTANCE-NAME por el nombre de la instancia de Spanner.
   • DATABASE-NAME por el nombre de la base de datos

2. Ejecuta gcloud spanner operations describe:

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

   Reemplaza lo siguiente:

   • OPERATION-ID: Es el ID de la operación que deseas verificar.
   • INSTANCE-NAME: Es el nombre de la instancia de Spanner.
   • DATABASE-NAME: Es el nombre de la base de datos de Spanner.

   La sección progress del resultado muestra el porcentaje de la operación que se completó. El resultado es similar al siguiente:

   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. Obtén el ID de operación:

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

   Reemplaza lo siguiente:

   • INSTANCE-NAME por el nombre de la instancia de Spanner.
   • DATABASE-NAME por el nombre de la base de datos

2. Verifica el progreso de la operación.

   Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

   • PROJECT-ID: El ID del proyecto.
   • INSTANCE-ID: El ID de la instancia.
   • DATABASE-ID: Es el ID de la base de datos.
   • OPERATION-ID: Es el ID de la operación.

   Método HTTP y URL:

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

   Para enviar tu solicitud, expande una de estas opciones:

   curl (Linux, macOS o Cloud Shell)

   Nota: Con el siguiente comando, se supone que accediste a la CLI de gcloud con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login, o a través del uso de Cloud Shell, que accede de forma automática a la CLI de gcloud. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

   Ejecuta el siguiente comando:

   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)

   Nota: El siguiente comando supone que accediste a la CLI de gcloud con tu cuenta de usuario mediante la ejecución de gcloud init o gcloud auth login. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

   Ejecuta el siguiente comando:

   $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

   Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

   {
   ...
       "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 la operación tarda demasiado, puedes cancelarla. Para obtener más información, consulta Cancela una operación de base de datos de larga duración.

Borrar una base de datos

Si borras una base de datos, esta y todos sus datos se quitarán de forma permanente. La eliminación de la base de datos es irreversible. Si la protección contra la eliminación de bases de datos está habilitada en una base de datos, no podrás borrarla hasta que inhabilites su protección contra la eliminación.

Las copias de seguridad existentes no se borran cuando se borra una base de datos. Para obtener más información, consulta Copia de seguridad y restablecimiento.

Consola de Google Cloud

1. En la consola de Google Cloud , ve a la página Instancias de Spanner.

   Ir a Instancias de Spanner

2. Selecciona la instancia que contiene la base de datos que deseas borrar.

3. Selecciona la base de datos.

4. Haz clic en Borrar base de datos. Aparecerá una confirmación.

5. Escribe el nombre de la base de datos y haz clic en Borrar.

gcloud

Para borrar una base de datos con la herramienta de línea de comandos gcloud, usa gcloud spanner databases delete.

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

Se requieren las siguientes opciones:

DATABASE

: Es el ID de la base de datos o el identificador completamente calificado de la base de datos. Si se proporciona el identificador completamente calificado, se debe omitir la marca --instance.

--instance=INSTANCE

Instancia de Spanner para la base de datos.

Para obtener más detalles, consulta la referencia de gcloud.

DDL

El DDL no admite la sintaxis de eliminación de bases de datos.

¿Qué sigue?

• Crea una base de datos y cárgala con datos de muestra.
• Obtén más información sobre la referencia de DDL de GoogleSQL.
• Obtén más información sobre la referencia de DDL de PostgreSQL.
• Obtén más información para crear una copia de seguridad y restablecer una base de datos.
• Obtén más información para evitar la eliminación accidental de bases de datos.
• Obtén información para realizar actualizaciones de esquema.