인스턴스 만들기 및 관리

이 페이지에서는 Spanner 인스턴스의 생성, 나열, 수정 및 삭제 방법을 설명합니다.

인스턴스 만들기

Google Cloud 콘솔, Google Cloud CLI 또는 클라이언트 라이브러리를 사용하여 인스턴스를 만들 수 있습니다. 또한 선택적 읽기 전용 복제본을 추가하여 커스텀 인스턴스 구성으로 인스턴스를 만들 수 있습니다.

콘솔

Google Cloud 콘솔에서 Spanner 인스턴스 페이지로 이동합니다.
인스턴스 만들기를 클릭합니다.

인스턴스 만들기로 이동
버전 선택 섹션에서 Spanner 버전을 선택합니다.

여러 버전 간 사양을 비교하려면 버전 비교를 클릭합니다. 자세한 내용은 Spanner 버전 개요를 참조하세요.
계속을 클릭합니다.
인스턴스 이름 지정 섹션에 Google Cloud 콘솔에 표시할 인스턴스 이름을 입력합니다. 인스턴스 이름은 Google Cloud 프로젝트 내에서 고유해야 합니다.
인스턴스를 영구적으로 식별하는 인스턴스 ID를 입력합니다. 인스턴스 ID도 Google Cloud 프로젝트 내에서 고유해야 합니다. 인스턴스 ID는 나중에 변경할 수 없습니다.
계속을 클릭합니다.
인스턴스 구성 섹션의 구성 선택에서 리전, 이중 리전 또는 멀티 리전을 선택합니다.

참고: 이중 리전 및 멀티 리전 인스턴스 구성은 Enterprise Plus 버전에서만 사용 가능합니다. 3가지 구성 간의 사양을 비교하려면 리전 구성 비교를 클릭하세요.
드롭다운에서 구성 위치를 선택합니다.
선택사항: 읽기 전용 복제본을 Spanner 기본 구성에 추가하려면 먼저 Google Cloud CLI를 사용하여 커스텀 인스턴스 구성을 만듭니다. Enterprise 버전 및 Enterprise Plus 버전에서 선택적 읽기 전용 복제본을 기본 구성에 추가할 수 있습니다.
계속을 클릭합니다.
컴퓨팅 용량 할당 섹션의 단위 선택에서 다음 중 하나를 클릭합니다.
- 큰 인스턴스의 경우 노드. 노드 하나는 처리 단위 1,000개입니다.
- 작은 인스턴스의 경우 처리 단위
자세한 내용은 컴퓨팅 용량, 노드, 처리 단위를 참조하세요.
확장 모드 선택에서 다음 중 하나를 클릭합니다.
- 고정된 컴퓨팅 리소스 및 비용을 위해 컴퓨팅 용량을 수동으로 설정하려면 수동 할당
  - 수량은 이 인스턴스에 사용할 처리 단위 또는 노드 수를 나타냅니다.
- Spanner에서 컴퓨팅 용량을 자동으로 추가 및 삭제할 수 있는 자동 확장. 관리형 자동 확장 처리는 Spanner Enterprise 버전 및 Enterprise Plus 버전에서 사용 가능합니다. 관리형 자동 확장 처리에 대한 자세한 내용은 Spanner용 관리형 자동 확장 처리를 참조하세요. 다음 관리형 자동 확장 처리 옵션을 구성합니다.
  - 최소는 컴퓨팅 용량에 대해 선택하는 측정 단위에 따라 축소할 최소 한도를 나타냅니다. 자세한 내용은 최소 한도 확인을 참조하세요.
  - 최대는 컴퓨팅 용량에 대해 선택하는 측정 단위에 따라 수직 확장할 최대 한도를 나타냅니다. 자세한 내용은 최대 한도 확인을 참조하세요.
  - 높은 우선순위 CPU 사용률 목표는 사용할 높은 우선순위 CPU의 목표 백분율을 나타냅니다. 자세한 내용은 CPU 사용률 목표 확인을 참조하세요.
  - 스토리지 사용률 목표는 사용할 스토리지의 목표 백분율을 나타냅니다. 자세한 내용은 스토리지 사용률 목표 확인을 참조하세요.
선택사항: 확장 모드로 자동 확장을 선택하면 비대칭 자동 확장 옵션 표시 드롭다운을 클릭하여 읽기 전용 복제본을 다른 복제본과 별개로 자동 확장할 수 있습니다. 자세한 내용은 비대칭 읽기 전용 자동 확장을 참조하세요.
1. 비대칭으로 자동 확장할 읽기 전용 복제본을 선택합니다.
2. 다음 비대칭 자동 확장 처리 옵션을 구성합니다.
  - 최소는 컴퓨팅 용량에 대해 선택하는 측정 단위에 따라 축소할 최소 한도를 나타냅니다. 자세한 내용은 최소 한도 확인을 참조하세요.
  - 최대는 컴퓨팅 용량에 대해 선택하는 측정 단위에 따라 수직 확장할 최대 한도를 나타냅니다. 자세한 내용은 최대 한도 확인을 참조하세요.
  - 높은 우선순위 CPU 사용률 목표는 사용할 높은 우선순위 CPU의 목표 백분율을 나타냅니다. 자세한 내용은 CPU 사용률 목표 확인을 참조하세요.
기본적으로 백업의 기본 백업 일정 사용 설정 체크박스가 선택되어 있습니다. 기본 백업 일정을 사용 중지하려면 체크박스를 선택 해제합니다. 사용 설정하면 인스턴스의 모든 새 데이터베이스에 24시간마다 전체 백업이 생성됩니다. 7일 동안 보관됩니다. 언제든지 기본 백업 일정을 수정하거나 삭제할 수 있습니다. 자세한 내용은 기본 백업 일정을 참조하세요.
만들기를 클릭하여 인스턴스를 만듭니다.

gcloud

gcloud spanner instances create 명령어를 사용하여 인스턴스를 만듭니다. 컴퓨팅 용량을 인스턴스에 사용할 노드 또는 처리 단위 수로 지정합니다.

gcloud spanner instances create INSTANCE_ID \
--edition=EDITION \
--config=INSTANCE_CONFIG \
--description=INSTANCE_DESCRIPTION \
--default-backup-schedule-type=DEFAULT_BACKUP_SCHEDULE_TYPE \
--nodes=NODE_COUNT

또는

gcloud spanner instances create INSTANCE_ID \
--edition=EDITION \
--config=INSTANCE_CONFIG \
--description=INSTANCE_DESCRIPTION \
--default-backup-schedule-type=DEFAULT_BACKUP_SCHEDULE_TYPE \
--processing-units=PROCESSING_UNIT_COUNT

다음을 바꿉니다.

INSTANCE-ID: Google Cloud 프로젝트 내에서 고유한 영구 식별자입니다. 인스턴스 ID는 나중에 변경할 수 없습니다.
INSTANCE-CONFIG: 인스턴스의 지리적 위치를 정의하고 데이터 복제 방식에 영향을 주는 인스턴스 구성의 영구 식별자입니다. 커스텀 인스턴스 구성의 경우 custom-로 시작합니다. 자세한 내용은 인스턴스 구성을 참조하세요.
INSTANCE_DESCRIPTION: Google Cloud 콘솔에 표시되는 인스턴스 이름입니다. 인스턴스 이름은Google Cloud 프로젝트 내에서 고유해야 합니다.
DEFAULT_BACKUP_SCHEDULE_TYPE: 인스턴스에서 사용되는 기본 백업 일정 유형입니다. 다음 값 중 하나여야 합니다.
- AUTOMATIC: 인스턴스에 새 데이터베이스가 생성되면 기본 백업 일정이 자동으로 생성됩니다. 기본 백업 일정에서는 24시간마다 전체 백업을 만듭니다. 이러한 전체 백업은 7일 동안 보관됩니다. 기본 백업 일정을 만든 후 수정하거나 삭제할 수 있습니다.
- NONE: 인스턴스에 새 데이터베이스가 생성될 때 기본 백업 일정이 자동으로 생성되지 않습니다.
NODE-COUNT: 인스턴스의 컴퓨팅 용량으로서 노드 수로 표현됩니다. 노드 1개는 처리 단위 1,000개와 같습니다.
PROCESSING_UNIT_COUNT: 인스턴스의 컴퓨팅 용량으로서 처리 단위 수로 표현됩니다. 최대 1,000개까지는 100의 배수(100, 200, 300 등)로 수량을 입력하고 더 큰 수량은 1,000의 배수(1000, 2000, 3000 등)로 입력합니다. 참고: 나중에 관리형 자동 확장 처리를 사용해서 사용 설정하려는 인스턴스를 만들 경우에는 이 매개변수를 사용하지 마세요.

관리형 자동 확장 추가

gcloud spanner instances create 명령어로 관리형 자동 확장을 사용할 Enterprise 버전 및 Enterprise Plus 버전 인스턴스를 만들 수도 있습니다. 자세한 내용은 Spanner용 관리형 자동 확장 처리를 참조하세요.

다음 명령어를 사용하여 관리형 자동 확장 처리로 인스턴스를 만듭니다.

  gcloud spanner instances create INSTANCE_ID \
    --edition=EDITION \
    --config=INSTANCE_CONFIG \
    --description=INSTANCE_DESCRIPTION \
    --autoscaling-min-processing-units=MINIMUM_PROCESSING_UNITS \
    --autoscaling-max-processing-units=MAXIMUM_PROCESSING_UNITS \
    --autoscaling-high-priority-cpu-target=CPU_PERCENTAGE \
    --autoscaling-storage-target=STORAGE_PERCENTAGE \
    [--asymmetric-autoscaling-option \
       location=ASYMMETRIC_AUTOSCALING_LOCATION,min_nodes=ASYMMETRIC_AUTOSCALING_MIN,\
       max_nodes=ASYMMETRIC_AUTOSCALING_MAX,high_priority_cpu_target=ASYMMETRIC_CPU_TARGET]

또는

  gcloud spanner instances create INSTANCE_ID \
    --edition=EDITION \
    --config=INSTANCE_CONFIG \
    --description=INSTANCE_DESCRIPTION \
    --autoscaling-min-nodes=MINIMUM_NODES \
    --autoscaling-max-nodes=MAXIMUM_NODES \
    --autoscaling-high-priority-cpu-target=CPU_PERCENTAGE \
    --autoscaling-storage-target=STORAGE_PERCENTAGE \
    [--asymmetric-autoscaling-option \
       location=ASYMMETRIC_AUTOSCALING_LOCATION,min_nodes=ASYMMETRIC_AUTOSCALING_MIN,\
       max_nodes=ASYMMETRIC_AUTOSCALING_MAX,high_priority_cpu_target=ASYMMETRIC_CPU_TARGET]

다음을 바꿉니다.

INSTANCE-ID: Google Cloud 프로젝트 내에서 고유한 영구 식별자입니다. 인스턴스 ID는 나중에 변경할 수 없습니다.
INSTANCE-CONFIG: 인스턴스의 지리적 위치를 정의하고 데이터 복제 방식에 영향을 주는 인스턴스 구성의 영구 식별자입니다. 커스텀 인스턴스 구성의 경우 custom-로 시작합니다. 자세한 내용은 인스턴스 구성을 참조하세요.
INSTANCE-DESCRIPTION: Google Cloud 콘솔에 표시되는 인스턴스 이름입니다. 인스턴스 이름은Google Cloud 프로젝트 내에서 고유해야 합니다.
MINIMUM_PROCESSING_UNITS, MINIMUM_NODES: 축소 시 처리 단위 또는 노드의 최소 개수입니다. 자세한 내용은 최소 한도 확인을 참조하세요.
MAXIMUM_PROCESSING_UNITS, MAXIMUM_NODES: 확장 시 처리 단위 또는 노드의 최대 개수입니다. 자세한 내용은 최대 한도 확인을 참조하세요.
CPU_PERCENTAGE: 사용할 높은 우선순위 CPU의 목표 백분율입니다(10~90%). 비용을 최적화하는 경우 높은 백분율을 사용합니다. 자세한 내용은 CPU 사용률 목표 확인을 참조하세요.
STORAGE_PERCENTAGE: 사용할 스토리지의 목표 백분율입니다(10~99%). 자세한 내용은 스토리지 사용률 목표 확인을 참조하세요.

선택적 플래그:

--asymmetric-autoscaling-option: 이 플래그를 사용하여 비대칭 자동 확장을 사용 설정합니다. 다음 매개변수를 바꿉니다.
- ASYMMETRIC_AUTOSCALING_LOCATION: 플래그가 사용되면 이 파라미터가 필요합니다. 비대칭으로 확장하려는 읽기 전용 리전의 위치입니다.
- ASYMMETRIC_AUTOSCALING_MIN: 선택적 파라미터입니다. 축소할 때의 최소 노드 수입니다.
- ASYMMETRIC_AUTOSCALING_MAX: 선택적 파라미터입니다. 수직 확장할 때의 최대 노드 수입니다.
- ASYMMETRIC_CPU_TARGET: 선택적 파라미터입니다. 사용할 우선순위가 높은 CPU의 목표 백분율입니다(10~90%). 비용을 최적화하는 경우에는 높은 백분율을 사용합니다.

커스텀 구성 사용 예시

기본 리전 인스턴스 구성 us-central1에서 test-instance 인스턴스를 만들려면 다음을 실행합니다.

gcloud spanner instances create test-instance --edition=STANDARD --config=regional-us-central1 \
  --description="Test Instance" --nodes=1

커스텀 멀티 리전 인스턴스 구성 custom-eur6에서 custom-eur6-instance 인스턴스를 만들려면 먼저 커스텀 인스턴스 구성 만들기를 수행합니다.

그런 후 다음을 실행합니다.

  gcloud spanner instances create custom-eur6-instance --edition=ENTERPRISE_PLUS --config=custom-eur6 \
      --description="Instance with custom read-only" --nodes=1

이전 명령어 중 하나를 실행한 후 다음 예시와 비슷한 메시지가 표시됩니다.

Creating instance...done.

C++

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

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

void CreateInstance(google::cloud::spanner_admin::InstanceAdminClient client,
                    std::string const& project_id,
                    std

인스턴스 만들기 및 관리 컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.