실습 설정 안내 및 요구사항
계정과 진행 상황을 보호하세요. 이 실습을 실행하려면 항상 시크릿 브라우저 창과 실습 사용자 인증 정보를 사용하세요.

Database Migration Service를 사용하여 PostgreSQL용 Cloud SQL로 마이그레이션

실습 1시간 10분 universal_currency_alt 크레딧 1개 show_chart 입문
info 이 실습에는 학습을 지원하는 AI 도구가 통합되어 있을 수 있습니다.
이 콘텐츠는 아직 휴대기기에 최적화되지 않음
최상의 경험을 위해 데스크톱 컴퓨터에서 이메일로 전송된 링크를 사용하여 방문하세요.

GSP918

Google Cloud 사용자 주도형 실습 로고

개요

Database Migration Service는 데이터를 Cloud SQL로 마이그레이션하기 위해 일회성 작업 및 연속 작업 옵션을 제공합니다. 또한 IP 허용 목록, 역방향 SSH 터널, VPC 피어링, Private Service Connect 인터페이스 등 다양한 연결 방식을 제공합니다. 연결 옵션에 대한 자세한 내용은 연결 구성 가이드를 참조하세요.

이 실습은 가상 머신에 호스팅된 독립형 PostgreSQL 데이터베이스를 PostgreSQL용 Cloud SQL로 마이그레이션하는 데 중점을 둡니다. 이 마이그레이션은 Database Migration Service의 연속 작업을 사용하며 VPC 피어링을 활용하여 연결을 설정합니다.

Database Migration Service를 사용하여 데이터베이스를 마이그레이션하려면 소스 데이터베이스에서 몇 가지 사전 준비 단계가 필요합니다.

  • 전용 사용자 만들기: 이 사용자는 복제 권한을 가져야 합니다.
  • pglogical 확장 프로그램 추가: 이 확장 프로그램은 소스 데이터베이스에 설치되어 있어야 합니다.
  • 필요한 권한 부여: 전용 사용자에게 마이그레이션 대상 데이터베이스 내의 스키마와 테이블, 그리고 postgres 데이터베이스에 대한 권한을 부여해야 합니다.

설정이 완료되면 마이그레이션 작업을 만들고 실행합니다. 마이그레이션 프로세스에는 다음 단계가 포함됩니다.

  • 초기 복사: 데이터베이스의 초기 복사본이 Cloud SQL 인스턴스로 성공적으로 전송되었는지 확인합니다.
  • 연속 마이그레이션: 진행 중인 마이그레이션 작업이 소스의 실시간 데이터 변경사항을 Cloud SQL 인스턴스에 어떻게 적용하는지 살펴봅니다.
  • 승격: Cloud SQL 인스턴스를 읽기 및 쓰기가 가능한 독립형 데이터베이스로 승격하여 마이그레이션 작업을 마무리합니다.

실습할 내용

  • 마이그레이션을 위해 소스 데이터베이스를 준비합니다.
  • PostgreSQL 인스턴스(예: 독립형 PostgreSQL)로의 소스 연결에 대한 프로필을 만듭니다.
  • VPC 피어링을 사용하여 소스 및 대상 데이터베이스 인스턴스 간의 연결을 구성합니다.
  • 마이그레이션을 위해 소스 데이터베이스에 대한 액세스를 허용하도록 방화벽 및 데이터베이스 액세스 규칙을 구성합니다.
  • Database Migration Service를 사용하여 연속 마이그레이션 작업을 만들고, 실행하고, 확인합니다.
  • 대상 인스턴스(PostgreSQL용 Cloud SQL)를 데이터 읽기 및 쓰기를 위한 독립형 데이터베이스로 승격합니다.

설정 및 요건

실습 시작 버튼을 클릭하기 전에

다음 안내를 확인하세요. 실습에는 시간 제한이 있으며 일시중지할 수 없습니다. 실습 시작을 클릭하면 타이머가 시작됩니다. 이 타이머는 Google Cloud 리소스를 사용할 수 있는 시간이 얼마나 남았는지를 표시합니다.

실무형 실습을 통해 시뮬레이션이나 데모 환경이 아닌 실제 클라우드 환경에서 실습 활동을 진행할 수 있습니다. 실습 시간 동안 Google Cloud에 로그인하고 액세스하는 데 사용할 수 있는 새로운 임시 사용자 인증 정보가 제공됩니다.

이 실습을 완료하려면 다음을 준비해야 합니다.

  • 표준 인터넷 브라우저 액세스 권한(Chrome 브라우저 권장)
참고: 이 실습을 실행하려면 시크릿 모드(권장) 또는 시크릿 브라우저 창을 사용하세요. 개인 계정과 학습자 계정 간의 충돌로 개인 계정에 추가 요금이 발생하는 일을 방지해 줍니다.
  • 실습을 완료하기에 충분한 시간(실습을 시작하고 나면 일시중지할 수 없음)
참고: 이 실습에는 학습자 계정만 사용하세요. 다른 Google Cloud 계정을 사용하는 경우 해당 계정에 비용이 청구될 수 있습니다.

실습을 시작하고 Google Cloud 콘솔에 로그인하는 방법

  1. 실습 시작 버튼을 클릭합니다. 실습 비용을 결제해야 하는 경우 결제 수단을 선택할 수 있는 대화상자가 열립니다. 왼쪽에는 다음과 같은 항목이 포함된 실습 세부정보 창이 있습니다.

    • Google Cloud 콘솔 열기 버튼
    • 남은 시간
    • 이 실습에 사용해야 하는 임시 사용자 인증 정보
    • 필요한 경우 실습 진행을 위한 기타 정보
  2. Google Cloud 콘솔 열기를 클릭합니다(Chrome 브라우저를 실행 중인 경우 마우스 오른쪽 버튼으로 클릭하고 시크릿 창에서 링크 열기를 선택합니다).

    실습에서 리소스가 가동되면 다른 탭이 열리고 로그인 페이지가 표시됩니다.

    팁: 두 개의 탭을 각각 별도의 창으로 나란히 정렬하세요.

    참고: 계정 선택 대화상자가 표시되면 다른 계정 사용을 클릭합니다.
  3. 필요한 경우 아래의 사용자 이름을 복사하여 로그인 대화상자에 붙여넣습니다.

    {{{user_0.username | "Username"}}}

    실습 세부정보 창에서도 사용자 이름을 확인할 수 있습니다.

  4. 다음을 클릭합니다.

  5. 아래의 비밀번호를 복사하여 시작하기 대화상자에 붙여넣습니다.

    {{{user_0.password | "Password"}}}

    실습 세부정보 창에서도 비밀번호를 확인할 수 있습니다.

  6. 다음을 클릭합니다.

    중요: 실습에서 제공하는 사용자 인증 정보를 사용해야 합니다. Google Cloud 계정 사용자 인증 정보를 사용하지 마세요. 참고: 이 실습에 자신의 Google Cloud 계정을 사용하면 추가 요금이 발생할 수 있습니다.
  7. 이후에 표시되는 페이지를 클릭하여 넘깁니다.

    • 이용약관에 동의합니다.
    • 임시 계정이므로 복구 옵션이나 2단계 인증을 추가하지 않습니다.
    • 무료 체험판을 신청하지 않습니다.

잠시 후 Google Cloud 콘솔이 이 탭에서 열립니다.

참고: Google Cloud 제품 및 서비스에 액세스하려면 탐색 메뉴를 클릭하거나 검색창에 제품 또는 서비스 이름을 입력합니다. 탐색 메뉴 아이콘 및 검색창

Cloud Shell 활성화

Cloud Shell은 다양한 개발 도구가 탑재된 가상 머신으로, 5GB의 영구 홈 디렉터리를 제공하며 Google Cloud에서 실행됩니다. Cloud Shell을 사용하면 명령줄을 통해 Google Cloud 리소스에 액세스할 수 있습니다.

  1. Google Cloud 콘솔 상단에서 Cloud Shell 활성화 Cloud Shell 활성화 아이콘를 클릭합니다.

  2. 다음 창을 클릭합니다.

    • Cloud Shell 정보 창을 통해 계속 진행합니다.
    • 사용자 인증 정보를 사용하여 Google Cloud API를 호출할 수 있도록 Cloud Shell을 승인합니다.

연결되면 사용자 인증이 이미 처리된 것이며 프로젝트가 학습자의 PROJECT_ID, (으)로 설정됩니다. 출력에 이 세션의 PROJECT_ID를 선언하는 줄이 포함됩니다.

Your Cloud Platform project in this session is set to {{{project_0.project_id | "PROJECT_ID"}}}

gcloud는 Google Cloud의 명령줄 도구입니다. Cloud Shell에 사전 설치되어 있으며 명령줄 자동 완성을 지원합니다.

  1. (선택사항) 다음 명령어를 사용하여 활성 계정 이름 목록을 표시할 수 있습니다.
gcloud auth list
  1. 승인을 클릭합니다.

출력:

ACTIVE: * ACCOUNT: {{{user_0.username | "ACCOUNT"}}} To set the active account, run: $ gcloud config set account `ACCOUNT`
  1. (선택사항) 다음 명령어를 사용하여 프로젝트 ID 목록을 표시할 수 있습니다.
gcloud config list project

출력:

[core] project = {{{project_0.project_id | "PROJECT_ID"}}} 참고: gcloud 전체 문서는 Google Cloud에서 gcloud CLI 개요 가이드를 참고하세요.

Database Migration API가 사용 설정되어 있는지 확인

Database Migration API는 Database Migration Service를 통해 데이터베이스 데이터를 이동 및 관리하기 위해 필요합니다.

  1. Google Cloud 콘솔 제목 표시줄의 검색 필드에 Database Migration API를 입력한 후, 검색 결과에서 Database Migration API를 클릭합니다.

API가 사용 설정되어 있으면 관리 버튼이 표시됩니다.

  1. 사용 설정 버튼이 보이면 클릭하여 API를 사용 설정합니다.

Service Networking API가 사용 설정되어 있는지 확인

Cloud SQL이 VPC 피어링 및 비공개 IP 주소를 통한 연결을 지원하도록 구성하려면 Service Networking API가 필요합니다.

  1. Cloud 콘솔 제목 표시줄의 검색 필드에 Service Networking API를 입력한 후, 검색 결과에서 Service Networking API를 클릭합니다.

API가 사용 설정되어 있으면 관리 버튼이 표시됩니다.

  1. 사용 설정 버튼이 보이면 클릭하여 API를 사용 설정합니다.

작업 1. 마이그레이션을 위해 소스 데이터베이스 준비

Database Migration Service를 통해 소스 데이터베이스를 마이그레이션하도록 준비하기 위해 pglogical 확장 프로그램으로 데이터베이스를 업그레이드한 후 데이터베이스 마이그레이션 사용자를 만듭니다.

pglogical 확장 프로그램으로 데이터베이스를 업그레이드하려면 다음을 수행합니다.

  • pglogical 데이터베이스 확장 프로그램을 설치하고 구성합니다.
  • Cloud Shell 및 Cloud SQL에서 액세스할 수 있도록 독립형 PostgreSQL 데이터베이스를 구성합니다.
  • 독립형 서버의 postgres, orders, gmemegen_db 데이터베이스에 pglogical 데이터베이스 확장 프로그램을 추가합니다.

데이터베이스 마이그레이션 사용자를 만들기 위해 복제 권한을 가진 migration_admin 사용자를 만든 후 필요한 스키마 및 관계에 대한 권한을 부여합니다.

pglogical 확장 프로그램으로 데이터베이스 업그레이드

이 섹션에서는 postgresql-vm VM 인스턴스의 orders 및 postgres 데이터베이스에 pglogical 데이터베이스 확장 프로그램을 다운로드하여 추가합니다.

  1. Google Cloud 콘솔의 탐색 메뉴(탐색 메뉴 아이콘)에서 Compute Engine > VM 인스턴스를 클릭합니다.

  2. postgresql-vm VM 인스턴스에서 SSH를 클릭합니다.

  3. 메시지가 표시되면 승인을 클릭합니다.

  4. 새 터미널 창에서 pglogical 데이터베이스 확장 프로그램을 설치합니다.

sudo apt install postgresql-14-pglogical 참고: pglogical은 논리적 복제 시스템으로, 전체가 PostgreSQL 확장 프로그램으로 구현되어 있습니다. 완전히 통합되어 있기 때문에 트리거나 외부 프로그램이 필요하지 않습니다. 물리적 복제에 대한 이러한 대안은 선택적 복제를 위해 게시/구독 모델을 사용하여 데이터를 복제하는 매우 효율적인 방법입니다.
  1. (pglogical 확장 프로그램을 사용 설정하기 위해) PostgreSQL 구성 파일에 몇 가지 추가 항목을 다운로드하여 적용하고 postgresql 서비스를 다시 시작합니다.
sudo su - postgres -c "gsutil cp gs://spls/gsp918/pg_hba_append.conf ." sudo su - postgres -c "gsutil cp gs://spls/gsp918/postgresql_append.conf ." sudo su - postgres -c "cat pg_hba_append.conf >> /etc/postgresql/14/main/pg_hba.conf" sudo su - postgres -c "cat postgresql_append.conf >> /etc/postgresql/14/main/postgresql.conf" sudo systemctl restart postgresql@14-main

pg_hba.conf에서 이러한 파일은 모든 호스트로부터의 액세스를 허용하는 규칙을 추가합니다.

#GSP918 - allow access to all hosts host all all 0.0.0.0/0 md5

postgresql.conf에 추가된 이러한 명령어는 pglogical이 모든 주소에서 수신 대기하도록 구성하기 위한 최소 구성을 설정합니다.

#GSP918 - added configuration for pglogical database extension wal_level = logical # minimal, replica, or logical max_worker_processes = 10 # one per database needed on provider node # one per node needed on subscriber node max_replication_slots = 10 # one per node needed on provider node max_wal_senders = 10 # one per node needed on provider node shared_preload_libraries = 'pglogical' max_wal_size = 1GB min_wal_size = 80MB listen_addresses = '*' # what IP address(es) to listen on, '*' is all

위의 코드 스니펫이 관련 파일에 추가되고 PostgreSQL 서비스가 다시 시작되었습니다.

  1. psql 도구를 실행합니다.
sudo su - postgres psql
  1. postgres, orders, gmemegen_db 데이터베이스에 pglogical 데이터베이스 확장 프로그램을 추가합니다.
\c postgres; CREATE EXTENSION pglogical; \c orders; CREATE EXTENSION pglogical; \c gmemegen_db; CREATE EXTENSION pglogical;
  1. 서버의 PostgreSQL 데이터베이스를 나열합니다.
\l

아래 출력에는 기본 postgresql 데이터베이스와 함께 이 실습을 위해 제공된 ordersgmemegen_db 데이터베이스가 나열됩니다. 이 실습에서는 gmemegen_db 데이터베이스를 사용하지 않습니다.

List of databases Name | Owner | Encoding | Collate | Ctype | Access privileges -------------+----------+----------+---------+---------+----------------------- gmemegen_db | postgres | UTF8 | C.UTF-8 | C.UTF-8 | orders | postgres | UTF8 | C.UTF-8 | C.UTF-8 | postgres | postgres | UTF8 | C.UTF-8 | C.UTF-8 | template0 | postgres | UTF8 | C.UTF-8 | C.UTF-8 | =c/postgres + | | | | | postgres=CTc/postgres template1 | postgres | UTF8 | C.UTF-8 | C.UTF-8 | =c/postgres + | | | | | postgres=CTc/postgres (5 rows)

데이터베이스 마이그레이션 사용자 만들기

이 섹션에서는 데이터베이스 마이그레이션을 관리하기 위한 전용 사용자를 만듭니다.

  • psql에서 아래 명령어를 입력하여 복제 역할을 가진 새 사용자를 만듭니다.
CREATE USER migration_admin PASSWORD 'DMS_1s_cool!'; ALTER DATABASE orders OWNER TO migration_admin; ALTER ROLE migration_admin WITH REPLICATION;

마이그레이션 사용자에게 권한 할당

이 섹션에서는 migration_admin 사용자에게 필요한 권한을 할당하여 Database Migration Service를 사용 설정하고 데이터베이스를 마이그레이션할 수 있도록 합니다.

  1. psql에서 postgres 데이터베이스의 pglogical 스키마와 테이블에 대한 권한을 부여합니다.
\c postgres; GRANT USAGE ON SCHEMA pglogical TO migration_admin; GRANT ALL ON SCHEMA pglogical TO migration_admin; GRANT SELECT ON pglogical.tables TO migration_admin; GRANT SELECT ON pglogical.depend TO migration_admin; GRANT SELECT ON pglogical.local_node TO migration_admin; GRANT SELECT ON pglogical.local_sync_status TO migration_admin; GRANT SELECT ON pglogical.node TO migration_admin; GRANT SELECT ON pglogical.node_interface TO migration_admin; GRANT SELECT ON pglogical.queue TO migration_admin; GRANT SELECT ON pglogical.replication_set TO migration_admin; GRANT SELECT ON pglogical.replication_set_seq TO migration_admin; GRANT SELECT ON pglogical.replication_set_table TO migration_admin; GRANT SELECT ON pglogical.sequence_state TO migration_admin; GRANT SELECT ON pglogical.subscription TO migration_admin;
  1. orders 데이터베이스의 pglogical 스키마와 테이블에 대한 권한을 부여합니다.
\c orders; GRANT USAGE ON SCHEMA pglogical TO migration_admin; GRANT ALL ON SCHEMA pglogical TO migration_admin; GRANT SELECT ON pglogical.tables TO migration_admin; GRANT SELECT ON pglogical.depend TO migration_admin; GRANT SELECT ON pglogical.local_node TO migration_admin; GRANT SELECT ON pglogical.local_sync_status TO migration_admin; GRANT SELECT ON pglogical.node TO migration_admin; GRANT SELECT ON pglogical.node_interface TO migration_admin; GRANT SELECT ON pglogical.queue TO migration_admin; GRANT SELECT ON pglogical.replication_set TO migration_admin; GRANT SELECT ON pglogical.replication_set_seq TO migration_admin; GRANT SELECT ON pglogical.replication_set_table TO migration_admin; GRANT SELECT ON pglogical.sequence_state TO migration_admin; GRANT SELECT ON pglogical.subscription TO migration_admin;
  1. orders 데이터베이스의 public 스키마와 테이블에 대한 권한을 부여합니다.
GRANT USAGE ON SCHEMA public TO migration_admin; GRANT ALL ON SCHEMA public TO migration_admin; GRANT SELECT ON public.distribution_centers TO migration_admin; GRANT SELECT ON public.inventory_items TO migration_admin; GRANT SELECT ON public.order_items TO migration_admin; GRANT SELECT ON public.products TO migration_admin; GRANT SELECT ON public.users TO migration_admin;
  1. gmemegen_db 데이터베이스의 pglogical 스키마와 테이블에 대한 권한을 부여합니다.
\c gmemegen_db; GRANT USAGE ON SCHEMA pglogical TO migration_admin; GRANT ALL ON SCHEMA pglogical TO migration_admin; GRANT SELECT ON pglogical.tables TO migration_admin; GRANT SELECT ON pglogical.depend TO migration_admin; GRANT SELECT ON pglogical.local_node TO migration_admin; GRANT SELECT ON pglogical.local_sync_status TO migration_admin; GRANT SELECT ON pglogical.node TO migration_admin; GRANT SELECT ON pglogical.node_interface TO migration_admin; GRANT SELECT ON pglogical.queue TO migration_admin; GRANT SELECT ON pglogical.replication_set TO migration_admin; GRANT SELECT ON pglogical.replication_set_seq TO migration_admin; GRANT SELECT ON pglogical.replication_set_table TO migration_admin; GRANT SELECT ON pglogical.sequence_state TO migration_admin; GRANT SELECT ON pglogical.subscription TO migration_admin;
  1. gmemegen_db 데이터베이스의 public 스키마와 테이블에 대한 권한을 부여합니다.
GRANT USAGE ON SCHEMA public TO migration_admin; GRANT ALL ON SCHEMA public TO migration_admin; GRANT SELECT ON public.meme TO migration_admin;

이제 소스 데이터베이스가 마이그레이션할 준비가 되었습니다. migration_admin 사용자에게 부여한 권한은 Database Migration Servicepostgres, orders, gmemegen_db 데이터베이스를 마이그레이션하는 데 필요한 모든 권한입니다.

나중에 마이그레이션을 테스트할 때 소스 데이터를 편집할 수 있도록 migration_admin 사용자를 orders 데이터베이스의 테이블 소유자로 설정합니다.

  1. 다음 명령어를 실행합니다.
\c orders; \dt ALTER TABLE public.distribution_centers OWNER TO migration_admin; ALTER TABLE public.inventory_items OWNER TO migration_admin; ALTER TABLE public.order_items OWNER TO migration_admin; ALTER TABLE public.products OWNER TO migration_admin; ALTER TABLE public.users OWNER TO migration_admin; \dt

출력

List of relations Schema | Name | Type | Owner --------+----------------------+-------+------- public | distribution_centers | table | migration_admin public | inventory_items | table | migration_admin public | order_items | table | migration_admin public | products | table | migration_admin public | users | table | migration_admin (5 rows)
  1. psql 및 postgres 사용자 세션을 종료합니다.
\q exit

내 진행 상황 확인하기를 클릭하여 목표를 확인합니다. 마이그레이션을 위해 PostgreSQL 소스 인스턴스를 준비합니다.

작업 2. 독립형 PostgreSQL 데이터베이스에 대한 Database Migration Service 연결 프로필 만들기

이 작업에서는 PostgreSQL 소스 인스턴스에 대한 연결 프로필을 만듭니다.

PostgreSQL 소스 인스턴스에 대한 연결 정보 가져오기

이 단계에서는 Cloud SQL로 마이그레이션할 소스 데이터베이스 인스턴스의 내부 IP 주소를 식별합니다.

  1. Google Cloud 콘솔의 탐색 메뉴(탐색 메뉴 아이콘)에서 Compute Engine > VM 인스턴스를 클릭합니다.

  2. 인스턴스 목록에서 postgresql-vm을 찾습니다.

  3. 다음 섹션에서 연결 프로필을 구성하는 데 사용할 내부 IP(예: 10.128.0.2)를 복사합니다.

PostgreSQL 소스 인스턴스에 대한 새 연결 프로필 만들기

연결 프로필은 소스 데이터베이스 인스턴스(예: 독립형 PostgreSQL)에 대한 정보를 저장하며, Database Migration Service는 소스에서 대상 Cloud SQL 데이터베이스 인스턴스로 데이터를 마이그레이션하는 데 이를 사용합니다. 연결 프로필을 만든 후에는 마이그레이션 작업 전반에서 재사용할 수 있습니다.

이 단계에서는 PostgreSQL 소스 인스턴스에 대한 새 연결 프로필을 만듭니다.

  1. Google Cloud 콘솔의 탐색 메뉴(탐색 메뉴 아이콘)에서 모든 제품 보기를 클릭합니다. 데이터베이스 섹션에서 데이터베이스 마이그레이션 > 연결 프로필을 클릭합니다.

  2. 프로필 만들기를 클릭합니다.

  3. 다음 필드를 지정하고 나머지는 기본값으로 둡니다.

필드
프로필 역할 소스
데이터베이스 엔진 PostgreSQL
연결 프로필 이름 postgres-vm
리전
연결 구성 정의 정의
호스트 이름 또는 IP 주소 이전 작업에서 복사한 PostgreSQL 소스 인스턴스의 내부 IP(예: 10.128.0.2)
포트 5432
사용자 이름 migration_admin
비밀번호 DMS_1s_cool!
  1. 저장을 클릭합니다.

  2. 만들기를 클릭합니다.

postgres-vm이라는 새 연결 프로필이 연결 프로필 목록에 표시됩니다.

내 진행 상황 확인하기를 클릭하여 목표를 확인합니다. PostgreSQL 소스 인스턴스에 대한 연결 프로필을 만듭니다.

작업 3. 연속 마이그레이션 작업 만들기 및 시작

새 마이그레이션 작업을 만들려면 먼저 기존 연결 프로필을 사용하여 소스 데이터베이스 인스턴스를 지정해야 합니다. 다음으로, 대상 데이터베이스 인스턴스를 설정하고 소스 인스턴스와 대상 인스턴스 간에 필요한 연결을 구성합니다.

이 작업에서는 마이그레이션 작업 인터페이스를 사용하여 새 PostgreSQL용 Cloud SQL 데이터베이스 인스턴스를 만들고 이를 PostgreSQL 소스 인스턴스로부터의 연속 마이그레이션 작업의 대상으로 설정합니다.

새 연속 마이그레이션 작업 만들기

이 단계에서는 새로운 연속 마이그레이션 작업을 만듭니다.

  1. 콘솔의 탐색 메뉴(탐색 메뉴 아이콘)에서 모든 제품 보기를 클릭합니다. 데이터베이스 섹션 아래의 데이터베이스 마이그레이션 > 마이그레이션 작업을 클릭합니다.

  2. 마이그레이션 작업 만들기를 클릭합니다.

  3. 다음 필드를 지정하고 나머지는 기본값으로 둡니다.

필드
마이그레이션 작업 이름 vm-to-cloudsql
소스 데이터베이스 엔진 PostgreSQL
대상 데이터베이스 엔진 PostgreSQL용 Cloud SQL
대상 리전
마이그레이션 작업 유형 연속
  1. 저장하고 계속하기를 클릭합니다.

소스 인스턴스 정의

이 단계에서는 마이그레이션을 위한 소스 인스턴스를 정의합니다.

  1. 소스 연결 프로필에서 postgres-vm을 선택합니다.

다른 설정은 기본값을 그대로 유지합니다.

  1. 저장하고 계속하기를 클릭합니다.

대상 인스턴스 정의

이 단계에서는 마이그레이션을 위한 대상 인스턴스를 정의합니다.

  1. 대상 인스턴스 유형에서 기존 인스턴스를 선택합니다.

  2. 대상 인스턴스 선택에서 postgresql-cloudsql을 선택합니다.

  3. 선택하고 계속하기를 클릭합니다.

  4. 확인 메시지가 표시되면 인스턴스 이름 postgresql-cloudsql을 입력합니다.

  5. 확인하고 계속하기를 클릭합니다.

참고: 다음 경고 메시지는 무시하세요. 대상 인스턴스의 순위가 내려가고 소스 데이터베이스의 복제본으로 변환됩니다.

연결 방법 정의

이 단계에서는 마이그레이션을 위한 연결 방법을 정의합니다.

대상 Cloud SQL 인스턴스가 생성되면 '구성하고 계속하기' 버튼이 사용 설정되었다는 메시지가 표시됩니다.

  1. 연결 방법에서 VPC 피어링을 선택합니다.

  2. VPC에서 기본값을 선택합니다.

VPC 피어링은 VPC 네트워크(이 예에서는 기본 네트워크)에 대해 제공된 정보를 사용하여 Database Migration Service에서 구성합니다.

대상 인스턴스가 생성되었다는 업데이트된 메시지가 표시되면 다음 단계로 진행합니다.

이 업데이트된 메시지는 대상 Cloud SQL 인스턴스가 생성되었음을 알려줍니다.

  1. 구성하고 계속하기를 클릭합니다.

마이그레이션 데이터베이스 구성

이 단계에서는 마이그레이션을 위한 소스 인스턴스를 정의합니다.

  1. 마이그레이션할 데이터베이스에서 모든 데이터베이스를 선택합니다.

  2. 저장하고 계속하기를 클릭합니다.

자동으로 할당된 IP 범위에서 postgresql-vm 인스턴스에 대한 액세스 허용

이 단계에서는 Database Migration Service에서 독립형 PostgreSQL 데이터베이스에 액세스할 수 있도록 pg_hba.conf PostgreSQL 구성 파일을 수정합니다.

  1. 할당된 IP 주소 범위를 가져옵니다. 콘솔의 탐색 메뉴(탐색 메뉴 아이콘)에서 VPC 네트워크를 클릭한 후 VPC 네트워크 피어링을 마우스 오른쪽 버튼으로 클릭하고 새 탭에서 엽니다.

  2. servicenetworking-googleapis-com 항목을 클릭한 후 하단의 효과적인 경로 뷰를 클릭합니다.

  3. 네트워크 드롭다운에서 기본값을 선택하고 리전에서 을(를) 선택합니다. 보기를 클릭합니다.

  4. 대상 IP 범위 열에서 peering-route-xxxxx... 경로 옆에 표시된 IP range(예: 10.107.176.0/24)를 기록해 둡니다. 이는 다음 단계에서 사용됩니다.

  5. VM 인스턴스의 터미널 세션에서 다음과 같이 pg_hba.conf 파일을 수정합니다.

sudo nano /etc/postgresql/14/main/pg_hba.conf
  1. 다음을 파일 마지막 줄에 입력합니다.
#GSP918 - allow access to all hosts host all all 0.0.0.0/0 md5

'모든 IP 주소' 범위(0.0.0.0/0)를 이전 단계에서 기록한 범위로 바꿉니다.

#GSP918 - allow access to all hosts host all all 10.107.176.0/24 md5 참고: 위의 단계는 마이그레이션 작업을 만들기 위해 반드시 필요한 것은 아니지만 마이그레이션 과정에서 소스 데이터베이스를 더 안전하게 만드는 데 좋은 방법입니다. 또한 마이그레이션 후 마이그레이션된 데이터베이스가 정보 소스가 되었을 때 액세스를 제한합니다.
  1. Ctrl+O, Enter, Ctrl+X를 차례로 눌러 파일을 저장하고 nano 편집기를 종료합니다.

  2. 변경사항을 적용하려면 PostgreSQL 서비스를 다시 시작합니다. VM 인스턴스 터미널 세션에 다음을 입력합니다.

sudo systemctl start postgresql@14-main

연속 마이그레이션 작업 테스트 및 시작하기

이 단계에서는 마이그레이션 작업을 테스트하고 시작합니다.

  1. 앞서 연 Database Migration Service 탭에서 마이그레이션 작업의 세부정보를 검토합니다.

  2. 작업 테스트를 클릭합니다.

  3. 테스트가 성공적으로 완료된 후 작업 만들기 및 시작을 클릭합니다.

  4. 확인하라는 메시지가 나타나면 만들고 시작하기를 클릭합니다.

연속 마이그레이션 작업의 상태 검토

이 단계에서는 연속 마이그레이션 작업이 실행 중인지 확인합니다.

  1. Google Cloud 콘솔의 탐색 메뉴(탐색 메뉴 아이콘)에서 데이터베이스 마이그레이션 > 마이그레이션 작업을 클릭합니다.

  2. 마이그레이션 작업 vm-to-cloudsql을 클릭하고 세부정보 페이지를 표시합니다.

  3. 마이그레이션 작업 상태를 검토합니다.

    • 작업을 시작하지 않은 경우 상태는 시작되지 않음으로 표시됩니다. 작업을 시작하거나 삭제하도록 선택할 수 있습니다.
    • 작업이 시작되면 상태는 시작 중으로 표시되고 전체 덤프 진행 중으로 전환되어 초기 데이터베이스 덤프가 진행 중임을 알 수 있습니다.
    • 초기 데이터베이스 덤프가 완료되면 상태는 CDC 실행 진행 중으로 전환되어 연속 마이그레이션이 활성 상태임을 알 수 있습니다.

작업 상태가 CDC 실행 진행 중으로 변경되면 다음 작업으로 진행합니다.

내 진행 상황 확인하기를 클릭하여 목표를 확인합니다. 연속 마이그레이션 작업을 만들고 시작하고 검토합니다.

작업 4. PostgreSQL용 Cloud SQL에서 데이터 확인

Cloud SQL에서 PostgreSQL 데이터베이스 확인

  1. Google Cloud 콘솔의 탐색 메뉴(탐색 메뉴 아이콘)에서 SQL을 클릭합니다.

  2. postgresql-cloudsql-master라는 인스턴스 ID를 확장합니다.

  3. postgresql-cloudsql(PostgreSQL 읽기 복제본) 인스턴스를 클릭합니다.

  4. 복제본 인스턴스 메뉴에서 데이터베이스를 클릭합니다.

postgres, orders, gmemegen_db라는 데이터베이스가 Cloud SQL로 마이그레이션되었음을 알 수 있습니다.

PostgreSQL 인스턴스에 연결하기

  1. 복제본 인스턴스 메뉴에서 개요를 클릭합니다.

  2. 이 인스턴스에 연결 섹션까지 아래로 스크롤하여 Cloud Shell 열기를 클릭합니다.

PostgreSQL에 연결하는 명령어가 Cloud Shell에 자동 입력됩니다.

gcloud sql connect postgresql-cloudsql --user=postgres --quiet
  1. 자동 입력된 명령어를 실행합니다.

  2. 메시지가 표시되면 API에 대해 승인을 클릭합니다.

  3. 비밀번호를 입력하라는 메시지가 표시되면 이전에 설정한 아래의 비밀번호를 입력합니다.

supersecret!

이제 대상 인스턴스에 대한 PostgreSQL 대화형 콘솔을 사용 설정했습니다.

PostgreSQL용 Cloud SQL 인스턴스의 데이터 검토

  1. PostgreSQL 대화형 콘솔에서 데이터베이스를 선택하려면 다음 명령어를 실행합니다.
\c orders;
  1. 비밀번호를 입력하라는 메시지가 표시되면 다음을 입력합니다.
supersecret!
  1. distribution_centers 테이블을 쿼리합니다.
select * from distribution_centers;

(출력)

longitude | latitude | name | id -----------+----------+---------------------------------------------+---- -89.9711 | 35.1174 | Memphis TN | 1 -87.6847 | 41.8369 | Chicago IL | 2 -95.3698 | 29.7604 | Houston TX | 3 -118.25 | 34.05 | Los Angeles CA | 4 -90.0667 | 29.95 | New Orleans LA | 5 -73.7834 | 40.634 | Port Authority of New York/New Jersey NY/NJ | 6 -75.1667 | 39.95 | Philadelphia PA | 7 -88.0431 | 30.6944 | Mobile AL | 8 -79.9333 | 32.7833 | Charleston SC | 9 -81.1167 | 32.0167 | Savannah GA | 10
  1. 다음을 입력하여 PostgreSQL 대화형 콘솔을 종료합니다.
\q

연속 마이그레이션을 테스트하기 위해 독립형 소스 데이터 업데이트

  1. Cloud Shell에서 다음 명령어를 입력하여 소스 PostgreSQL 인스턴스에 연결합니다.
export VM_NAME=postgresql-vm export PROJECT_ID=$(gcloud config list --format 'value(core.project)') export POSTGRESQL_IP=$(gcloud compute instances describe ${VM_NAME} \ --zone={{{ project_0.default_zone|(zone) }}} --format="value(networkInterfaces[0].accessConfigs[0].natIP)") echo $POSTGRESQL_IP psql -h $POSTGRESQL_IP -p 5432 -d orders -U migration_admin 참고: 위의 방법은 VM 인스턴스에서 독립형 데이터베이스에 액세스하는 대안적인 접근법입니다.
  1. 비밀번호를 입력하라는 메시지가 표시되면 다음을 입력합니다.
DMS_1s_cool!
  1. psql에서 다음 명령어를 입력합니다.
\c orders; insert into distribution_centers values(-80.1918,25.7617,'Miami FL',11);
  1. 대화형 psql 세션을 닫습니다.
\q

업데이트된 데이터가 마이그레이션되었는지 확인하기 위해 Cloud SQL PostgreSQL 데이터베이스에 연결

  1. Cloud Shell에서 다음 명령어를 입력하여 대상 Cloud SQL PostgreSQL 인스턴스에 연결합니다.
gcloud sql connect postgresql-cloudsql --user=postgres --quiet
  1. 이전에 설정한 비밀번호를 입력하라는 메시지가 표시되면 Cloud SQL 인스턴스의 비밀번호를 입력합니다.
supersecret!

이제 대상 인스턴스에 대한 PostgreSQL 대화형 콘솔을 사용 설정했습니다.

PostgreSQL용 Cloud SQL 데이터베이스의 데이터 검토하기

  1. Cloud Shell의 PostgreSQL 대화형 콘솔에서 활성 데이터베이스를 선택합니다.
\c orders;
  1. 비밀번호를 입력하라는 메시지가 표시되면 이전에 설정한 아래의 비밀번호를 입력합니다.
supersecret!
  1. distribution_centers 테이블을 쿼리합니다.
select * from distribution_centers;

(출력)

longitude | latitude | name | id -----------+----------+---------------------------------------------+---- -89.9711 | 35.1174 | Memphis TN | 1 -87.6847 | 41.8369 | Chicago IL | 2 -95.3698 | 29.7604 | Houston TX | 3 -118.25 | 34.05 | Los Angeles CA | 4 -90.0667 | 29.95 | New Orleans LA | 5 -73.7834 | 40.634 | Port Authority of New York/New Jersey NY/NJ | 6 -75.1667 | 39.95 | Philadelphia PA | 7 -88.0431 | 30.6944 | Mobile AL | 8 -79.9333 | 32.7833 | Charleston SC | 9 -81.1167 | 32.0167 | Savannah GA | 10 -80.1918 | 25.7617 | Miami FL | 11

독립형 orders 데이터베이스에 추가된 새 행이 이제 마이그레이션된 데이터베이스에도 존재합니다.

  1. PostgreSQL 대화형 콘솔을 종료합니다.
\q

내 진행 상황 확인하기를 클릭하여 목표를 확인합니다. 소스에서 대상으로의 연속 데이터 마이그레이션을 테스트합니다.

작업 5. Cloud SQL을 데이터 읽기 및 쓰기를 위한 독립형 인스턴스로 승격

  1. Google Cloud 콘솔의 탐색 메뉴(탐색 메뉴 아이콘)에서 모든 제품 보기를 클릭합니다. 데이터베이스 섹션 아래의 데이터베이스 마이그레이션 > 마이그레이션 작업을 클릭합니다.

  2. 마이그레이션 작업 이름 vm-to-cloudsql을 클릭하고 세부정보 페이지를 표시합니다.

  3. 승격을 클릭합니다.

  4. 확인하라는 메시지가 나타나면 승격을 클릭합니다.

승격이 완료되면 작업 상태가 완료됨으로 업데이트됩니다.

  1. Google Cloud 콘솔의 탐색 메뉴(탐색 메뉴 아이콘)에서 모든 제품 보기를 클릭합니다. 데이터베이스 섹션에서 SQL을 클릭합니다.

이제 postgresql-cloudsql은 데이터 읽기 및 쓰기를 위한 독립형 인스턴스입니다.

내 진행 상황 확인하기를 클릭하여 목표를 확인합니다. 데이터 읽기 및 쓰기를 위한 독립형 인스턴스가 될 수 있도록 PostgreSQL용 Cloud SQL 데이터베이스를 승격합니다.

수고하셨습니다

PostgreSQL 인스턴스에서 PostgreSQL용 Cloud SQL로 데이터베이스를 마이그레이션하기 위해 연속 Database Migration Service 작업을 구성했습니다.

다음 단계/더 학습하기

데이터 마이그레이션, Cloud SQL 데이터베이스, Database Migration Service에 대해 자세히 알아보세요.

Google Cloud 교육 및 자격증

Google Cloud 기술을 최대한 활용하는 데 도움이 됩니다. Google 강의에는 빠른 습득과 지속적인 학습을 지원하는 기술적인 지식과 권장사항이 포함되어 있습니다. 기초에서 고급까지 수준별 학습을 제공하며 바쁜 일정에 알맞은 주문형, 실시간, 가상 옵션이 포함되어 있습니다. 인증은 Google Cloud 기술에 대한 역량과 전문성을 검증하고 입증하는 데 도움이 됩니다.

설명서 최종 업데이트: 2025년 12월 10일

실습 최종 테스트: 2025년 12월 10일

Copyright 2026 Google LLC. All rights reserved. Google 및 Google 로고는 Google LLC의 상표입니다. 기타 모든 회사명 및 제품명은 해당 업체의 상표일 수 있습니다.

시작하기 전에

  1. 실습에서는 정해진 기간 동안 Google Cloud 프로젝트와 리소스를 만듭니다.
  2. 실습에는 시간 제한이 있으며 일시중지 기능이 없습니다. 실습을 종료하면 처음부터 다시 시작해야 합니다.
  3. 화면 왼쪽 상단에서 실습 시작을 클릭하여 시작합니다.

시크릿 브라우징 사용

  1. 실습에 입력한 사용자 이름비밀번호를 복사합니다.
  2. 비공개 모드에서 콘솔 열기를 클릭합니다.

콘솔에 로그인

    실습 사용자 인증 정보를 사용하여
  1. 로그인합니다. 다른 사용자 인증 정보를 사용하면 오류가 발생하거나 요금이 부과될 수 있습니다.
  2. 약관에 동의하고 리소스 복구 페이지를 건너뜁니다.
  3. 실습을 완료했거나 다시 시작하려고 하는 경우가 아니면 실습 종료를 클릭하지 마세요. 이 버튼을 클릭하면 작업 내용이 지워지고 프로젝트가 삭제됩니다.

현재 이 콘텐츠를 이용할 수 없습니다

이용할 수 있게 되면 이메일로 알려드리겠습니다.

감사합니다

이용할 수 있게 되면 이메일로 알려드리겠습니다.

한 번에 실습 1개만 가능

모든 기존 실습을 종료하고 이 실습을 시작할지 확인하세요.

시크릿 브라우징을 사용하여 실습 실행하기

이 실습을 실행하려면 시크릿 모드 또는 시크릿 브라우저 창을 사용하세요. 개인 계정과 학생 계정 간의 충돌로 개인 계정에 추가 요금이 발생하는 일을 방지해 줍니다.