Crear y administrar bases de datos

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

  • Varios métodos para crear una base de datos
  • Modificar las opciones de la base de datos
  • Eliminar una base de datos

Esta página contiene información sobre las bases de datos con dialecto GoogleSQL y con dialecto PostgreSQL. Para saber cómo actualizar un esquema de base de datos, consulta Hacer cambios en el esquema. Para obtener más información sobre cómo crear una instancia, consulta Crear y gestionar instancias. Puede crear una base de datos en una instancia de cualquiera de las siguientes formas:

  • Crear una base de datos: puedes crear una seleccionando el dialecto SQL y definiendo el esquema.
  • Importar tus propios datos: puedes importar un archivo CSV, de volcado de MySQL o de volcado de PostgreSQL en una base de datos nueva o ya creada.
  • Crear una base de datos con datos de muestra: puede rellenar una base de datos con uno de los conjuntos de datos de muestra disponibles para probar las funciones de Spanner.

Crear una base de datos

Puedes crear una base de datos en una instancia que ya tengas. En las bases de datos con dialecto GoogleSQL, puedes definir el esquema de la base de datos en el momento de crearla o después. En las bases de datos con dialecto PostgreSQL, debes definir el esquema después de la creación.

Los esquemas se definen mediante el lenguaje de definición de base de datos, que se documenta en GoogleSQL y PostgreSQL. Consulta los siguientes enlaces para obtener más información sobre cómo crear y actualizar esquemas:

Una vez que hayas creado tu base de datos, puedes proteger las bases de datos importantes para tus aplicaciones y servicios habilitando la protección contra eliminación de bases de datos. Para obtener más información, consulta Evitar la eliminación accidental de bases de datos.

Google Cloud consola

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

    Ir a instancias de Spanner

  2. Selecciona la instancia en la que quieres crear la base de datos.

  3. Haz clic en Crear base de datos.

  4. Introduce los siguientes valores:

    • Un nombre de base de datos que se mostrará en la Google Cloud consola.
    • El dialecto que se va a usar en esta base de datos.
    • En el caso de las bases de datos con dialecto GoogleSQL, puedes proporcionar un conjunto de instrucciones DDL que definan tu esquema. Usa las plantillas de DDL para rellenar previamente los elementos habituales. Si hay errores en las instrucciones DDL, la consola devuelve un error cuando intentas crear la base de datos. Google Cloud
    • También puedes seleccionar una clave de cifrado gestionada por el cliente para usarla 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 …]
```

Debes seleccionar las siguientes opciones:

DATABASE
ID de la base de datos o identificador completo de la base de datos. Si se especifica el identificador completo, se puede omitir la marca --instance.
--instance=INSTANCE
La instancia de Spanner de la base de datos.

Las siguientes opciones son opcionales:

--async
Devuelve el valor inmediatamente, sin esperar a que se complete la operación en curso.
--database-dialect=DATABASE_DIALECT
El dialecto SQL de la base de datos de Spanner. Debe ser uno de los siguientes valores: POSTGRESQL o GOOGLE_STANDARD_SQL.
--ddl=DDL
Instrucciones DDL (lenguaje de definición de datos) separadas por punto y coma que se ejecutarán en la base de datos recién creada. Si hay un error en alguna instrucción, no se crea la base de datos. Esta marca se ignora si se define --ddl_file. No es compatible con bases de datos de dialecto PostgreSQL.
--ddl-file=DDL_FILE
Ruta de un archivo que contiene instrucciones DDL (lenguaje de definición de datos) separadas por punto y coma para ejecutar en la base de datos recién creada. Si hay un error en alguna instrucción, no se crea la base de datos. Si se define --ddl_file, se ignora --ddl. No es compatible con bases de datos de dialecto PostgreSQL.

Si especificas una clave de Cloud Key Management Service para usarla al crear la base de datos, incluye las siguientes opciones:

--kms-key=KMS_KEY
ID de la clave o identificador completo de la clave.

Esta marca debe especificarse si se especifica alguno de los demás argumentos de este grupo. Los demás argumentos se pueden omitir si se proporciona el identificador completo.

--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 clave.
--kms-project=KMS_PROJECT
Google Cloud ID de proyecto de la clave.

Cliente (GoogleSQL)

C++

Para saber cómo instalar y usar la biblioteca de cliente de Spanner, consulta Bibliotecas de cliente de Spanner.

Para autenticarte en Spanner, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación en 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 saber cómo instalar y usar la biblioteca de cliente de Spanner, consulta Bibliotecas de cliente de Spanner.

Para autenticarte en Spanner, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación en 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 saber cómo instalar y usar la biblioteca de cliente de Spanner, consulta Bibliotecas de cliente de Spanner.

Para autenticarte en Spanner, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación en 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);
    }
  }
}

Node.js

Para saber cómo instalar y usar la biblioteca de cliente de Spanner, consulta Bibliotecas de cliente de Spanner.