데이터베이스 생성 및 관리

이 페이지에서는 데이터베이스 생성, 데이터베이스 옵션 수정, 데이터베이스 삭제 방법을 비롯하여 Spanner 데이터베이스를 관리하는 방법을 설명합니다. 데이터베이스 스키마를 업데이트하는 방법을 알아보려면 스키마 업데이트 만들기를 참조하세요.

데이터베이스를 만들고 샘플 데이터로 로드하는 방법을 알아보려면 첫 번째 데이터베이스 Codelab을 참조하세요.

데이터베이스 만들기

다음 예시에서는 기존 인스턴스에서 데이터베이스를 만드는 방법을 보여줍니다.

GoogleSQL 언어 데이터베이스의 경우 데이터베이스를 만들 때 또는 데이터베이스를 만든 후에 데이터베이스 스키마를 정의할 수 있습니다. PostgreSQL 언어 데이터베이스의 경우에는 만든 후에 스키마를 정의해야 합니다.

스키마는 GoogleSQL 및 PostgreSQL에 문서화된 데이터베이스 정의 언어를 통해 정의됩니다. 스키마 생성 및 업데이트에 대한 자세한 내용은 다음 링크를 참조하세요.

• 스키마 및 데이터 모델
• 스키마 설계 권장사항
• 스키마 업데이트

데이터베이스를 만든 후 데이터베이스 삭제 보호를 사용 설정하여 애플리케이션과 서비스에 중요한 데이터베이스를 보호할 수 있습니다. 자세한 내용은 실수로 인한 데이터베이스 삭제 방지를 참조하세요.

콘솔

1. Google Cloud 콘솔에서 Spanner 인스턴스 페이지로 이동합니다.

   Spanner 인스턴스로 이동

2. 데이터베이스를 만들 인스턴스를 선택합니다.

3. 데이터베이스 만들기를 클릭합니다.

4. 다음 값을 입력합니다.

   • Google Cloud 콘솔에서 표시할 데이터베이스 이름.
   • 이 데이터베이스에 사용할 언어.
   • GoogleSQL 언어 데이터베이스의 경우 필요에 따라 스키마를 정의하는 DDL 문 집합을 제공합니다. 공통 요소를 미리 채우려면 DDL 템플릿을 사용하세요. DDL 문에 오류가 있으면 데이터베이스를 만들려고 할 때 Google Cloud 콘솔에서 오류가 반환됩니다.
   • 필요한 경우 이 데이터베이스에 사용할 고객 관리 암호화 키를 선택합니다.

5. 만들기를 클릭하여 데이터베이스를 만듭니다.

gcloud

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

다음 옵션이 필요합니다.

DATABASE

데이터베이스의 ID 또는 데이터베이스의 정규화된 식별자. 정규화된 식별자를 지정하는 경우 --instance 플래그를 생략할 수 있습니다.

--instance=INSTANCE

데이터베이스의 Cloud Spanner 인스턴스.

다음 옵션은 선택사항입니다.

--async

진행 중인 작업이 완료되기를 기다리지 않고 즉시 반환합니다.

--database-dialect=DATABASE_DIALECT

Spanner 데이터베이스의 SQL 언어. POSTGRESQL, GOOGLE_STANDARD_SQL 중 하나여야 합니다.

--ddl=DDL

새로 생성된 데이터베이스 내에서 실행할 세미콜론으로 구분된 DDL(데이터 정의 언어) 문. 문에 오류가 있으면 데이터베이스가 생성되지 않습니다. --ddl_file이 설정된 경우 이 플래그는 무시됩니다. PostgreSQL 언어 데이터베이스에서는 지원되지 않습니다.

--ddl-file=DDL_FILE

새로 생성된 데이터베이스 내에서 실행할 세미콜론으로 구분된 DDL(데이터 정의 언어) 문이 포함된 파일의 경로. 문에 오류가 있으면 데이터베이스가 생성되지 않습니다. --ddl_file이 설정된 경우 --ddl이 무시됩니다. PostgreSQL 언어 데이터베이스에서는 지원되지 않습니다.

데이터베이스를 만들 때 사용할 Cloud Key Management Service 키를 지정하는 경우 다음 옵션을 포함합니다.

--kms-key=KMS_KEY

키의 ID 또는 키의 정규화된 식별자입니다.

이 그룹의 다른 인수가 지정된 경우 이 플래그를 지정해야 합니다. 정규화된 식별자가 제공된 경우 다른 인수는 생략될 수 있습니다.

--kms-keyring=KMS_KEYRING

키의 Cloud KMS 키링 ID입니다.

--kms-location=KMS_LOCATION

키의 Google Cloud 위치입니다.

--kms-project=KMS_PROJECT

키의 Google Cloud 프로젝트 ID입니다.

클라이언트(GoogleSQL)

C++

Spanner용 클라이언트 라이브러리를 설치하고 사용하는 방법은 Spanner 클라이언트 라이브러리를 참조하세요.

Spanner에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.

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

Spanner용 클라이언트 라이브러리를 설치하고 사용하는 방법은 Spanner 클라이언트 라이브러리를 참조하세요.

Spanner에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.

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
}

자바

Spanner용 클라이언트 라이브러리를 설치하고 사용하는 방법은 Spanner 클라이언트 라이브러리를 참조하세요.

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

참고: Java용 이전 클라이언트 라이브러리 인터페이스 코드 샘플은 GitHub에 보관처리됩니다.

Node.js

Spanner용 클라이언트 라이브러리를 설치하고 사용하는 방법은 Spanner 클라이언트 라이브러리를 참조하세요.

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

참고: Node.js용 이전 클라이언트 라이브러리 인터페이스 코드 샘플은 GitHub에 보관처리됩니다.

PHP

Spanner용 클라이언트 라이브러리를 설치하고 사용하는 방법은 Spanner 클라이언트 라이브러리를 참조하세요.

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

참고: PHP용 이전 클라이언트 라이브러리 인터페이스 코드 샘플은 GitHub에 보관처리됩니다.

Python

Spanner용 클라이언트 라이브러리를 설치하고 사용하는 방법은 Spanner 클라이언트 라이브러리를 참조하세요.

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

참고: Python용 이전 클라이언트 라이브러리 인터페이스 코드 샘플은 GitHub에 보관처리됩니다.

Ruby

Spanner용 클라이언트 라이브러리를 설치하고 사용하는 방법은 Spanner 클라이언트 라이브러리를 참조하세요.

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}"

데이터베이스 스키마 또는 옵션 업데이트

DDL 문을 사용하여 데이터베이스 스키마와 옵션을 업데이트할 수 있습니다.

예를 들어 열을 테이블에 추가하려면 다음 DDL 문을 사용합니다.

GoogleSQL

ALTER TABLE Songwriters ADD COLUMN Publisher STRING(10);

PostgreSQL

ALTER TABLE Songwriters ADD COLUMN Publisher VARCHAR(10);

쿼리 최적화 도구 버전을 업데이트하려면 다음 DDL 문을 사용합니다.

GoogleSQL

ALTER DATABASE Music SET OPTIONS(optimizer_version=null);

PostgreSQL

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

지원되는 옵션에 대한 자세한 내용은 GoogleSQL 또는 PostgreSQL에 대한 ALTER DATABASE DDL 참조를 확인하세요.

스키마 업데이트에 대한 자세한 내용은 스키마 업데이트를 참조하세요.

콘솔

1. Google Cloud 콘솔에서 인스턴스 페이지로 이동합니다.

   인스턴스

2. 변경할 데이터베이스가 포함된 인스턴스를 선택합니다.

3. 데이터베이스를 선택합니다.

4. Spanner 스튜디오를 클릭합니다.

5. 새 탭을 클릭하거나 빈 편집기 탭을 사용합니다. 그런 다음 적용할 DDL 문을 입력합니다.

6. 실행을 클릭하여 업데이트를 적용합니다. DDL에 오류가 있으면 Google Cloud 콘솔이 오류를 반환하고 데이터베이스가 변경되지 않습니다.

gcloud

gcloud 명령줄 도구를 사용하여 데이터베이스를 변경하려면 gcloud spanner databases ddl update를 사용합니다.

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

사용 가능한 옵션에 대한 자세한 내용은 gcloud 참조를 확인하세요.

--ddl 플래그 또는 --ddl-file 플래그를 사용하여 데이터베이스 업데이트를 명령어에 전달합니다. DDL 파일을 지정한 경우 --ddl 플래그는 무시됩니다.

포함할 DDL 문은 GoogleSQL 또는 PostgreSQL에 대한 ALTER DATABASE DDL 참조를 확인하세요.

DDL

자세한 내용은 GoogleSQL 또는 PostgreSQL에 대한 ALTER DATABASE DDL 참조를 확인하세요.

스키마 업데이트 작업 진행 상황 확인

콘솔

1. Spanner 탐색 메뉴에서 작업 탭을 선택합니다. 작업 페이지에 현재 실행 중인 작업 목록이 표시됩니다.

2. 목록에서 스키마 작업을 찾습니다. 아직 실행 중이면 다음 이미지와 같이 종료 시간 열의 진행률 표시줄에 완료된 작업의 비율이 표시됩니다.

gcloud

gcloud spanner operations describe를 사용하여 작업 진행 상황을 확인합니다.

1. 작업 ID를 가져옵니다.

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

   다음을 바꿉니다.

   • INSTANCE-NAME: Spanner 인스턴스 이름
   • DATABASE-NAME: 데이터베이스 이름

2. gcloud spanner operations describe을 실행합니다.

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

   다음을 바꿉니다.

   • OPERATION-ID: 확인할 작업의 작업 ID
   • INSTANCE-NAME: Spanner 인스턴스 이름
   • DATABASE-NAME: Spanner 데이터베이스 이름

   출력의 progress 섹션에 완료된 작업의 비율이 표시됩니다. 결과는 다음과 유사합니다.

   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. 작업 ID를 가져옵니다.

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

   다음을 바꿉니다.

   • INSTANCE-NAME: Spanner 인스턴스 이름
   • DATABASE-NAME: 데이터베이스 이름

2. 작업 진행 상황을 확인합니다.

   요청 데이터를 사용하기 전에 다음을 바꿉니다.

   • PROJECT-ID: 프로젝트 ID
   • INSTANCE-ID: 인스턴스 ID
   • DATABASE-ID: 데이터베이스 ID
   • OPERATION-ID: 작업 ID

   HTTP 메서드 및 URL:

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

   요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

   cURL(Linux, macOS, Cloud Shell)

   참고: 다음 명령어는 gcloud init 또는 gcloud auth login을 실행하거나 gcloud CLI에 자동으로 로그인하는 Cloud Shell을 사용하여 사용자 계정으로 gcloud CLI에 로그인했다고 가정합니다. gcloud auth list를 실행하면 현재 활성 계정을 확인할 수 있습니다.

   다음 명령어를 실행합니다.

   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)

   참고: 다음 명령어는 gcloud init 또는 gcloud auth login을 실행하여 사용자 계정으로 gcloud CLI에 로그인했다고 가정합니다. gcloud auth list를 실행하면 현재 활성 계정을 확인할 수 있습니다.

   다음 명령어를 실행합니다.

   $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

   다음과 비슷한 JSON 응답이 표시됩니다.

   {
   ...
       "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"
     }
   }
   
   

작업에 시간이 너무 오래 걸리는 경우 취소할 수 있습니다. 자세한 내용은 장기 실행 데이터베이스 작업 취소를 참고하세요.

데이터베이스 삭제

데이터베이스를 삭제하면 데이터베이스 및 모든 데이터베이스 데이터가 영구적으로 삭제됩니다. 데이터베이스 삭제는 실행취소할 수 없습니다. 데이터베이스에서 데이터베이스 삭제 보호가 활성화된 경우 데이터베이스 삭제 보호를 사용 중지하기 전에는 해당 데이터베이스를 삭제할 수 없습니다.

데이터베이스가 삭제되더라도 기존 백업은 삭제되지 않습니다. 자세한 내용은 백업 및 복원을 참고하세요.

콘솔

1. Google Cloud 콘솔에서 인스턴스 페이지로 이동합니다.

   인스턴스

2. 삭제할 데이터베이스가 포함된 인스턴스를 선택합니다.

3. 데이터베이스를 선택합니다.

4. 데이터베이스 삭제를 클릭합니다. 확인 메시지가 표시됩니다.

5. 데이터베이스 이름을 입력하고 삭제를 클릭합니다.

gcloud

gcloud 명령줄 도구로 데이터베이스를 삭제하려면 gcloud spanner databases delete를 사용합니다.

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

다음 옵션이 필요합니다.

DATABASE

데이터베이스의 ID 또는 데이터베이스의 정규화된 식별자. 정규화된 식별자가 제공된 경우 --instance 플래그를 생략해야 합니다.

--instance=INSTANCE

데이터베이스의 Cloud Spanner 인스턴스.

자세한 내용은 gcloud 참조를 확인하세요.

DDL

DDL은 데이터베이스 삭제 문법을 지원하지 않습니다.

다음 단계

• 데이터베이스 만들기 및 샘플 데이터로 로드
• GoogleSQL DDL 참조 자세히 알아보기
• PostgreSQL DDL 참조에 대해 자세히 알아보세요.
• 데이터베이스 백업 및 복원 방법 알아보기
• 실수로 인한 데이터베이스 삭제를 방지하는 방법을 알아보세요.
• 스키마를 업데이트하는 방법을 알아보세요.