연결 프로필 관리

이 페이지에서는 연결 프로필에 대한 보기, 업데이트, 삭제 작업을 수행하는 방법을 설명합니다.

연결 프로필 보기

연결 프로필에 대한 다음 정보를 볼 수 있습니다.

• 프로필 생성 중에 제공된 모든 구성 세부정보입니다. 자세한 내용은 연결 프로필 개요를 참조하세요.

• 연결 프로필 생성 및 마지막 수정 시간입니다.

• 이 연결 프로필을 사용하는 마이그레이션 작업 목록입니다.

연결 프로필 세부정보를 보려면 다음 단계를 수행합니다.

콘솔

1. Google Cloud 콘솔에서 연결 프로필 페이지로 이동합니다.

   연결 프로필로 이동

2. 보려는 연결 프로필의 표시 이름을 클릭합니다.

   연결 프로필 개요 페이지가 표시됩니다.

gcloud

아래의 명령어 데이터를 사용하기 전에 다음을 바꿉니다.

• REGION을 연결 프로필이 저장된 리전의 식별자로 바꿉니다.
• CONNECTION_PROFILE_ID를 연결 프로필 식별자로 바꿉니다.

  식별자를 모르는 경우 gcloud database-migration connection-profiles list 명령어를 사용하여 지정된 리전의 모든 프로필을 나열하고 식별자를 볼 수 있습니다.

이러한 값에 대한 자세한 내용은 연결 프로필 개요를 참조하세요.

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

Linux, macOS 또는 Cloud Shell

참고: gcloud init 또는 gcloud auth login 및 gcloud config set project를 실행하여 Google Cloud CLI를 인증 및 프로젝트와 함께 초기화했는지 확인합니다.

gcloud database-migration connection-profiles \
describe CONNECTION_PROFILE_ID \
  --region=REGION

Windows(PowerShell)

참고: gcloud init 또는 gcloud auth login 및 gcloud config set project를 실행하여 Google Cloud CLI를 인증 및 프로젝트와 함께 초기화했는지 확인합니다.

gcloud database-migration connection-profiles `
describe CONNECTION_PROFILE_ID `
  --region=REGION

Windows(cmd.exe)

참고: gcloud init 또는 gcloud auth login 및 gcloud config set project를 실행하여 Google Cloud CLI를 인증 및 프로젝트와 함께 초기화했는지 확인합니다.

gcloud database-migration connection-profiles ^
describe CONNECTION_PROFILE_ID ^
  --region=REGION

연결 프로필 업데이트

다음 연결 프로필 세부정보를 수정할 수 있습니다.

• 표시 이름
• 소스 연결 프로필: 호스트 이름 또는 IP 주소, 포트, 사용자 이름, 비밀번호, 데이터베이스 이름, SSL/TLS 인증서
• 대상 연결 프로필 (기존 클러스터만 해당): 대상 PostgreSQL용 AlloyDB 클러스터 식별자

연결 프로필을 업데이트하려면 다음 단계를 수행합니다.

콘솔

1. Google Cloud 콘솔에서 연결 프로필 페이지로 이동합니다.

   연결 프로필로 이동

2. 수정할 연결 프로필의 표시 이름을 클릭합니다.

   연결 프로필의 개요 페이지가 표시됩니다.

3. 수정을 클릭하고 연결 프로필을 업데이트합니다.
4. 저장을 클릭합니다.

gcloud

아래의 명령어 데이터를 사용하기 전에 다음을 바꿉니다.

• CONNECTION_PROFILE_ID를 연결 프로필 식별자로 바꿉니다.

  식별자를 모르는 경우 gcloud database-migration connection-profiles list 명령어를 사용하여 지정된 리전의 모든 프로필을 나열하고 식별자를 볼 수 있습니다.

• REGION을 연결 프로필이 저장된 리전의 식별자로 바꿉니다.
• (선택사항) CONNECTION_PROFILE_NAME: 인간이 읽을 수 있는 연결 프로필 이름입니다. 이 값은 Google Cloud 콘솔에 표시됩니다.
• 소스 연결 프로필: --host, --port, --username, --password와 같은 플래그를 전달하여 소스 데이터베이스 연결 세부정보를 업데이트할 수도 있습니다. 지원되는 플래그의 전체 목록은 gcloud database-migration connection-profiles update 참조를 확인하세요.
• 대상 연결 프로필 (기존 클러스터만 해당): ALLOYDB_CLUSTER_ID를 대상 PostgreSQL용 AlloyDB 클러스터의 클러스터 식별자로 바꿉니다. PostgreSQL용 AlloyDB 클러스터 세부정보를 보는 방법은 PostgreSQL용 AlloyDB 문서의 클러스터 세부정보 보기를 참조하세요.

이러한 값에 대한 자세한 내용은 연결 프로필 개요를 참조하세요.

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

Linux, macOS 또는 Cloud Shell

참고: gcloud init 또는 gcloud auth login 및 gcloud config set project를 실행하여 Google Cloud CLI를 인증 및 프로젝트와 함께 초기화했는지 확인합니다.

gcloud database-migration connection-profiles \
update CONNECTION_PROFILE_ID \
  --region=REGION \
  --display-name=CONNECTION_PROFILE_NAME \
  --alloydb-cluster=ALLOYDB_CLUSTER_ID

Windows(PowerShell)

참고: gcloud init 또는 gcloud auth login 및 gcloud config set project를 실행하여 Google Cloud CLI를 인증 및 프로젝트와 함께 초기화했는지 확인합니다.

gcloud database-migration connection-profiles `
update CONNECTION_PROFILE_ID `
  --region=REGION `
  --display-name=CONNECTION_PROFILE_NAME `
  --alloydb-cluster=ALLOYDB_CLUSTER_ID

Windows(cmd.exe)

참고: gcloud init 또는 gcloud auth login 및 gcloud config set project를 실행하여 Google Cloud CLI를 인증 및 프로젝트와 함께 초기화했는지 확인합니다.

gcloud database-migration connection-profiles ^
update CONNECTION_PROFILE_ID ^
  --region=REGION ^
  --display-name=CONNECTION_PROFILE_NAME ^
  --alloydb-cluster=ALLOYDB_CLUSTER_ID

결과

작업은 비동기식으로 수행됩니다. 따라서 이 명령어는 장기 실행 작업을 나타내는 작업 항목을 반환합니다.

done: false
metadata:
  '@type': type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata
  apiVersion: v1
  createTime: '2024-02-20T12:20:24.493106418Z'
  requestedCancellation: false
  target: CONNECTION_PROFILE_ID
  verb: update
name: OPERATION_ID

작업이 성공했는지 확인하려면 반환된 작업 객체를 쿼리하거나 연결 프로필 세부정보를 확인하면 됩니다.

• gcloud database-migration connection-profiles describe 명령어를 사용하여 업데이트된 연결 프로필 세부정보를 확인합니다.
• gcloud database-migration operations describe 명령어를 OPERATION_ID와 함께 사용하여 작업 자체의 상태를 확인합니다.

연결 프로필 삭제

해당 프로필을 사용하는 마이그레이션 작업이 없는 경우에만 연결 프로필을 삭제할 수 있습니다. 마이그레이션 작업에서 사용 중인 연결 프로필을 삭제하려면 먼저 연결 프로필에 연결된 모든 마이그레이션 작업을 삭제합니다.

연결 프로필을 삭제하려면 다음 단계를 수행합니다.

콘솔

1. Google Cloud 콘솔에서 연결 프로필 페이지로 이동합니다.

   연결 프로필로 이동

2. 삭제하려는 연결 프로필의 표시 이름을 클릭합니다.

   연결 프로필 개요 페이지가 표시됩니다.

3. 삭제를 클릭합니다.
4. 대화상자에서 삭제를 클릭합니다.

gcloud

이 명령어는 완료하려면 입력이 필요한 대화형 확인 프롬프트를 반환합니다. 선택사항인 --quiet 플래그를 사용하여 확인 메시지를 건너뛸 수 있습니다.

아래의 명령어 데이터를 사용하기 전에 다음을 바꿉니다.

• REGION을 연결 프로필이 저장된 리전의 식별자로 바꿉니다.
• CONNECTION_PROFILE_ID를 연결 프로필 식별자로 바꿉니다.

  식별자를 모르는 경우 gcloud database-migration connection-profiles list 명령어를 사용하여 지정된 리전의 모든 프로필을 나열하고 식별자를 볼 수 있습니다.

이러한 값에 대한 자세한 내용은 연결 프로필 개요를 참조하세요.

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

Linux, macOS 또는 Cloud Shell

참고: gcloud init 또는 gcloud auth login 및 gcloud config set project를 실행하여 Google Cloud CLI를 인증 및 프로젝트와 함께 초기화했는지 확인합니다.

gcloud database-migration connection-profiles \
delete CONNECTION_PROFILE_ID \
  --region=REGION

Windows(PowerShell)

참고: gcloud init 또는 gcloud auth login 및 gcloud config set project를 실행하여 Google Cloud CLI를 인증 및 프로젝트와 함께 초기화했는지 확인합니다.

gcloud database-migration connection-profiles `
delete CONNECTION_PROFILE_ID `
  --region=REGION

Windows(cmd.exe)

참고: gcloud init 또는 gcloud auth login 및 gcloud config set project를 실행하여 Google Cloud CLI를 인증 및 프로젝트와 함께 초기화했는지 확인합니다.

gcloud database-migration connection-profiles ^
delete CONNECTION_PROFILE_ID ^
  --region=REGION

결과

delete 명령어는 작업을 확인하는 대화형 프롬프트를 반환합니다. Y를 입력하여 연결 프로필을 삭제합니다.

You are about to delete connection_profile [CONNECTION_PROFILE_ID]

Do you want to continue (Y/n)?

선택사항인 --quiet 플래그를 사용하여 Google Cloud CLI 대화형 확인 프롬프트를 건너뛸 수 있습니다.