인스턴스 생성 및 관리

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

인스턴스 생성

gcloud 명령줄 도구 또는 Google Cloud Console을 사용하여 인스턴스를 만들 수 있습니다.

Console

  1. Cloud Console에서 인스턴스 만들기 페이지로 이동합니다.

    인스턴스 만들기

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

    • Cloud Console에 표시할 인스턴스 이름. 인스턴스 이름은 Google Cloud 프로젝트 내에서 고유해야 합니다.
    • 인스턴스를 영구적으로 식별하는 인스턴스 ID. 인스턴스 ID도 Google Cloud 프로젝트 내에서 고유해야 합니다. 인스턴스 ID는 나중에 변경할 수 없습니다.
    • 인스턴스 노드의 지리적 위치를 정의하고 데이터 복제 방식에 영향을 주는 구성. 인스턴스 구성에 대해 자세히 알아보세요.
    • 인스턴스의 노드 수. 노드 수에 따라 인스턴스의 데이터베이스에서 사용할 수 있는 제공 리소스 및 스토리지 리소스의 양이 결정됩니다.
  3. 만들기를 클릭하여 인스턴스를 만듭니다.

다음 스크린샷은 인스턴스 만들기 페이지를 보여줍니다.

인스턴스 만들기 페이지의 스크린샷

gcloud

gcloud spanner instances create 명령어를 사용합니다.

gcloud spanner instances create [INSTANCE-ID] --config=[INSTANCE-CONFIG] \
    --description="[INSTANCE-NAME]" --nodes=[NODE-COUNT]

다음 값을 제공합니다.

  • [INSTANCE-ID]: Google Cloud 프로젝트 내에서 고유한 영구 식별자입니다. 인스턴스 ID는 나중에 변경할 수 없습니다.
  • [INSTANCE-CONFIG]: 인스턴스 노드의 지리적 위치를 정의하고 데이터 복제 방식에 영향을 주는 인스턴스 구성입니다. 인스턴스 구성에 대해 자세히 알아보세요.
  • [INSTANCE-NAME]: Cloud Console에서 표시되는 인스턴스 이름입니다. 인스턴스 이름은 Google Cloud 프로젝트 내에서 고유해야 합니다.
  • [NODE-COUNT]: 인스턴스의 노드 수입니다. 노드 수에 따라 인스턴스의 데이터베이스에서 사용할 수 있는 제공 리소스 및 스토리지 리소스의 양이 결정됩니다.

예를 들면 다음과 같습니다.

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

이 명령어를 실행하면 다음 예시와 유사한 메시지가 표시됩니다.

Creating instance...done.

인스턴스 나열

Console

Cloud Console에서 Spanner 인스턴스 페이지로 이동합니다.

인스턴스 페이지로 이동

Cloud Console에 Cloud Spanner 인스턴스의 목록과 함께 각 인스턴스의 ID, 표시 이름, 구성, 노드 수가 표시됩니다.

gcloud

gcloud spanner instances list 명령어를 사용합니다.

gcloud spanner instances list

그러면 gcloud 도구가 Cloud Spanner 인스턴스의 목록과 함께 각 인스턴스의 ID, 표시 이름, 구성, 노드 수를 출력합니다.

인스턴스 수정

다음 섹션에서는 인스턴스의 표시 이름과 노드 수를 변경하는 방법을 설명합니다. 인스턴스 ID나 인스턴스 구성은 변경할 수 없습니다.

표시 이름 변경

Console

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

    인스턴스 페이지로 이동

  2. 이름을 변경할 인스턴스 이름을 클릭합니다.

  3. 인스턴스 수정을 클릭합니다.

  4. 새 인스턴스 이름을 입력합니다. 이 이름은 Google Cloud 프로젝트 내에서 고유해야 합니다.

  5. 저장을 클릭합니다.

gcloud

gcloud spanner instances update 명령어를 사용합니다.

gcloud spanner instances update [INSTANCE-ID] --description=[INSTANCE-NAME]

다음 값을 제공합니다.

  • [INSTANCE-ID]: 인스턴스의 영구 식별자입니다.
  • [INSTANCE-NAME]: Cloud Console에서 표시되는 인스턴스 이름입니다. 인스턴스 이름은 Google Cloud 프로젝트 내에서 고유해야 합니다.

노드 수 변경

스토리지 요구사항을 충족하고 CPU 사용률을 권장되는 최댓값 아래로 유지하려면 충분한 수의 노드를 프로비저닝해야 합니다. 노드에서 제공하는 리소스에 대한 자세한 내용은 Cloud Spanner의 할당량 및 한도를 참조하세요.

다음과 같은 몇 가지 경우에는 기존 인스턴스에서 노드를 삭제할 수 없습니다.

  • 노드 삭제 시 인스턴스에 저장되는 데이터가 노드당 2TB를 초과하게 될 경우
  • 과거 사용량 패턴에 따라 Cloud Spanner가 인스턴스 데이터에 대해 많은 수의 분할을 만들었으며, 노드 삭제 후에는 Cloud Spanner가 분할을 관리할 수 없게 되는 경우

노드를 삭제할 때 CPU 사용률을 모니터링하고 Cloud Monitoring에서 지연 시간을 요청하여 CPU 사용률이 리전 인스턴스의 경우 65% 미만, 다중 리전 인스턴스의 각 리전에서 45% 미만으로 유지되도록 합니다. 노드를 삭제하는 동안 요청 지연 시간이 일시적으로 증가할 수 있습니다.

인스턴스의 노드 수를 늘리려면 Google Cloud 프로젝트에 노드를 추가할 수 있을 만큼 충분한 할당량이 있어야 합니다.

Console

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

    인스턴스 페이지로 이동

  2. 변경하려는 인스턴스의 이름을 클릭합니다.

  3. 인스턴스 수정을 클릭합니다.

  4. 원하는 노드 수를 입력합니다.

  5. 저장을 클릭합니다.

    할당량이 부족하여 이 위치에 노드를 추가할 수 없다는 대화상자가 표시되면 안내에 따라 할당량 상향을 요청하세요.

gcloud

gcloud spanner instances update 명령어를 사용합니다.

gcloud spanner instances update [INSTANCE-ID] --nodes=[NODE-COUNT]

다음 값을 제공합니다.

  • [INSTANCE-ID]: 인스턴스의 영구 식별자입니다.
  • [NODE-COUNT]: 인스턴스의 노드 수입니다.

인스턴스 삭제

Console

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

    인스턴스 페이지로 이동

  2. 삭제하려는 인스턴스의 이름을 클릭합니다.

  3. 인스턴스 삭제를 클릭합니다.

  4. 안내에 따라 인스턴스를 삭제할 것인지 확인합니다.

  5. 삭제를 클릭합니다.

gcloud

gcloud spanner instances delete 명령어를 사용합니다. 여기서 [INSTANCE-ID]는 인스턴스 ID로 바꿉니다.

gcloud spanner instances delete [INSTANCE-ID]

다음 단계