관리형 연결 풀링 구성

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

콘솔

1. 클러스터 페이지로 이동합니다.

   클러스터로 이동

2. 리소스 이름 열에서 클러스터를 클릭합니다.

3. 개요 페이지에서 클러스터의 인스턴스로 이동합니다.

4. 기본 수정 또는 읽기 풀 수정을 클릭합니다.

5. 관리형 연결 풀에서 관리형 연결 풀 사용 설정 체크박스를 선택합니다.

6. 선택사항: 관리형 연결 풀링 옵션을 구성하려면 고급 풀링 옵션을 클릭합니다.

   인스턴스의 요구사항에 맞게 관리형 연결 풀링 옵션을 맞춤설정할 수 있습니다. 자세한 내용은 고급 구성 옵션을 참고하세요.

7. 변경사항 저장을 클릭합니다.

gcloud

기존 기본 또는 읽기 풀 인스턴스에 관리형 연결 풀링을 사용 설정하려면 다음 gcloud alpha alloydb instances update 명령어를 사용합니다.

gcloud alpha alloydb instances update INSTANCE_ID \
  --project=PROJECT_ID \
  --region=REGION_ID \
  --cluster=CLUSTER_ID \
  --enable-connection-pooling

다음을 바꿉니다.

• INSTANCE_ID: 관리형 연결 풀링을 사용 설정하려는 AlloyDB 인스턴스의 ID입니다.
• PROJECT_ID: 프로젝트 ID입니다.
• REGION_ID: 리전 ID입니다.
• CLUSTER_ID: 클러스터의 ID입니다.

관리형 연결 풀링을 사용 설정한 후 고급 구성 옵션을 설정하여 인스턴스의 요구사항에 맞게 관리형 연결 풀링 옵션을 맞춤설정할 수 있습니다. 구성 옵션을 설정하는 방법에 관한 자세한 내용은 인스턴스의 관리형 연결 풀링 수정을 참고하세요.

REST

기존 기본 또는 읽기 풀 인스턴스에 관리형 연결 풀링을 사용 설정하려면 다음 명령어를 사용하고 connectionPoolConfig를 설정하세요.

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

• PROJECT_ID: 프로젝트 ID입니다.
• LOCATION_ID: 클러스터 리전의 ID입니다.
• CLUSTER_ID: 클러스터의 ID입니다. 소문자로 시작해야 하며 소문자, 숫자, 하이픈을 포함할 수 있습니다.
• INSTANCE_ID: 인스턴스의 ID입니다.

HTTP 메서드 및 URL:

PATCH https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID/instances/INSTANCE_ID

JSON 요청 본문:

{
  "connectionPoolConfig": {
    "enabled": true
  }
}

콘솔

1. 클러스터 페이지로 이동합니다.

   클러스터로 이동

2. 리소스 이름 열에서 클러스터를 클릭합니다.

3. 개요 페이지에서 클러스터의 인스턴스로 이동합니다.

4. 수정하려는 인스턴스의 인스턴스 수정 또는 읽기 풀 수정을 클릭합니다.

5. 관리형 연결 풀에서 고급 풀링 옵션을 펼칩니다.

6. 업데이트할 고급 풀링 옵션을 수정합니다. 다음 옵션을 수정할 수 있습니다.

   • 연결 모드
   • 최대 풀 크기
   • 최소 풀 크기
   • 최대 클라이언트 연결 수
   • 유휴 클라이언트 연결 제한 시간(초)
   • 유휴 서버 연결 제한 시간(초)
   • 쿼리 대기 제한 시간(초)
   • 준비된 최대 문 수
   • 시작 파라미터 무시
   • 서버 전체 기간(초)

7. 인스턴스 업데이트를 클릭합니다.

gcloud

기존 인스턴스의 관리형 연결 풀링 구성 옵션을 수정하려면 다음 gcloud alpha alloydb instances update 명령어를 사용합니다.

  gcloud alpha alloydb instances update INSTANCE_ID \
    --project=PROJECT_ID \
    --region=REGION_ID \
    --cluster=CLUSTER_ID \
    { \
      --connection-pooling-pool-mode=CONNECTION_MODE \
      | --connection-pooling-max-pool-size=MAX_POOL_SIZE \
      | --connection-pooling-min-pool-size=MIN_POOL_SIZE \
      | --connection-pooling-max-client-connections=MAX_CLIENT_CONNECTION \
      | --connection-pooling-server-idle-timeout=SERVER_IDLE_TIMEOUT_PERIOD \
      | --connection-pooling-query-wait-timeout=QUERY_WAIT_TIMEOUT_PERIOD \
      | --connection-pooling-ignore-startup-parameters=IGNORE_STARTUP_PARAMETERS \
    }

다음을 바꿉니다.

• INSTANCE_ID: 관리형 연결 풀링을 사용 중지하려는 AlloyDB 인스턴스의 이름입니다.
• PROJECT_ID: 프로젝트 ID입니다.
• REGION_ID: 리전 ID입니다.
• CLUSTER_ID: 클러스터의 ID입니다.

• 다음 옵션을 구성할 수 있습니다.

  • --connection-pooling-pool-mode. session 또는 transaction 중 하나여야 합니다.
  • --connection-pooling-max-pool-size
  • --connection-pooling-min-pool-size
  • --connection-pooling-max-client-connections
  • --connection-pooling-server-idle-timeout
  • --connection-pooling-query-wait-timeout
  • --connection-pooling-ignore-startup-parameters

REST

기존 읽기 풀 인스턴스의 관리형 연결 풀링 구성 옵션을 수정하려면 다음 명령어를 사용하고 connectionPoolConfig를 설정하세요.

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

• PROJECT_ID: 프로젝트 ID입니다.
• LOCATION_ID: 클러스터 리전의 ID입니다.
• CLUSTER_ID: 생성한 클러스터의 ID입니다. 소문자로 시작해야 하며 소문자, 숫자, 하이픈을 포함할 수 있습니다.
• INSTANCE_ID: 만든 인스턴스의 ID입니다.

• 다음 옵션을 구성할 수 있습니다.

  • POOL_MODE. session 또는 transaction 중 하나여야 합니다.
  • MAX_POOL_SIZE
  • MIN_POOL_SIZE
  • MAX_CLIENT_CONNECTION
  • SERVER_IDLE_TIMEOUT
  • QUERY_WAIT_TIMEOUT
  • IGNORE_STARTUP_PARAMETERS

HTTP 메서드 및 URL:

PATCH https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID/instances/INSTANCE_ID

JSON 요청 본문:

{
  "connectionPoolConfig": {
    "enabled": true,
    "flags": {
      "pool_mode": "POOL_MODE",
      "max_pool_size": "MAX_POOL_SIZE",
      "min_pool_size": "MIN_POOL_SIZE",
      "max_client_connection": "MAX_CLIENT_CONNECTION",
      "server_idle_timeout": "SERVER_IDLE_TIMEOUT",
      "query_wait_timeout": "QUERY_WAIT_TIMEOUT",
      "ignore_startup_parameters": "IGNORE_STARTUP_PARAMETERS"
    },
  }
}

콘솔

1. 클러스터 페이지로 이동합니다.

   클러스터로 이동

2. 리소스 이름 열에서 클러스터를 클릭합니다.

3. 개요 페이지에서 관리형 연결 풀링의 상태를 확인할 인스턴스를 찾습니다. 관리형 연결 풀링 필드는 사용 설정 또는 중지 여부를 나타냅니다.

gcloud

기존 인스턴스의 관리형 연결 풀링 상태를 보려면 다음 gcloud alpha alloydb instances describe 명령어를 사용합니다.

gcloud alpha alloydb instances describe INSTANCE_ID \
  --project=PROJECT_ID \
  --region=REGION_ID \
  --cluster=CLUSTER_ID \
  --format="value(connectionPoolConfig.enabled)"

다음을 바꿉니다.

• INSTANCE_ID: 관리형 연결 풀링 옵션을 수정하려는 AlloyDB 인스턴스의 이름입니다.
• PROJECT_ID: 프로젝트 ID입니다.
• REGION_ID: 리전 ID입니다.
• CLUSTER_ID: 클러스터의 ID입니다.

관리형 연결 풀링이 사용 설정된 경우 다음 응답이 반환됩니다.

True

REST

AlloyDB 인스턴스의 관리형 연결 풀링 상태를 보려면 다음 명령어를 사용하고 connectionPoolConfig를 찾습니다.

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

• PROJECT_ID: 프로젝트 ID입니다.
• LOCATION_ID: 클러스터 리전의 ID입니다.
• CLUSTER_ID: 생성한 클러스터의 ID입니다. 소문자로 시작해야 하며 소문자, 숫자, 하이픈을 포함할 수 있습니다.
• INSTANCE_ID: 만든 인스턴스의 ID입니다.

HTTP 메서드 및 URL:

GET https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID/instances/INSTANCE_ID

콘솔

1. 클러스터 페이지로 이동합니다.

   클러스터로 이동

2. 리소스 이름 열에서 클러스터를 클릭합니다.

3. 개요 페이지에서 클러스터의 인스턴스로 이동합니다.

4. 관리형 풀링 연결을 사용 중지하려는 인스턴스의 인스턴스 수정 또는 읽기 풀 수정을 클릭합니다.

5. 관리형 연결 풀에서 관리형 연결 풀 사용 설정 체크박스를 선택 해제합니다.

6. 인스턴스 업데이트를 클릭합니다.

gcloud

기존 인스턴스에 관리형 연결 풀링을 사용 중지하려면 다음 gcloud alpha alloydb instances update 명령어를 사용합니다.

gcloud alpha alloydb instances update INSTANCE_ID \
  --project=PROJECT_ID \
  --region=REGION_ID \
  --cluster=CLUSTER_ID \
  --no-enable-connection-pooling

다음을 바꿉니다.

• INSTANCE_ID: 관리형 연결 풀링을 사용 중지하려는 AlloyDB 인스턴스의 이름입니다.
• PROJECT_ID: 프로젝트 ID입니다.
• REGION_ID: 리전 ID입니다.
• CLUSTER_ID: 클러스터의 ID입니다.

REST

기존 읽기 풀 인스턴스에 대해 관리형 연결 풀링을 사용 중지하려면 다음 명령어를 사용하고 connectionPoolConfig를 false로 설정합니다.

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

• PROJECT_ID: 프로젝트 ID입니다.
• LOCATION_ID: 클러스터 리전의 ID입니다.
• CLUSTER_ID: 생성한 클러스터의 ID입니다. 소문자로 시작해야 하며 소문자, 숫자, 하이픈을 포함할 수 있습니다.
• INSTANCE_ID: 만든 인스턴스의 ID입니다.

HTTP 메서드 및 URL:

PATCH https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID/instances/INSTANCE_ID

JSON 요청 본문:

{
  "connectionPoolConfig": {
    "enabled": false
  }
}