GSP1084

總覽

在 Google Cloud，您可以使用資料庫遷移服務，將 PostgreSQL 資料庫遷移至 AlloyDB for PostgreSQL。為此，AlloyDB 需要使用私人服務連線。這種存取方式會以虛擬私有雲對接連線的方式運作，可連結您的虛擬私有雲網路與 AlloyDB 資源所在的 Google Cloud 虛擬私有雲網路。

在本實驗室中，您會透過資料庫遷移服務，使用虛擬私有雲對接連線並執行連續工作，將虛擬機器中執行的獨立 PostgreSQL 資料庫，遷移至 AlloyDB for PostgreSQL。

透過資料庫遷移服務遷移資料庫時，來源資料庫需要先做一些準備工作。來源環境已為您完成這些工作，其中最重要的就是來源執行個體中的 pglogical 套件設定。

建立並執行遷移工作後，您將確認資料庫的初始副本，已成功遷移至 AlloyDB for PostgreSQL 執行個體。您也將瞭解連續遷移工作如何將來源資料庫的資料更新內容，套用至 AlloyDB for PostgreSQL 執行個體。

學習內容

在本實驗室中，您將瞭解如何設定資料庫遷移服務的連續工作，將資料庫從 PostgreSQL 執行個體遷移至 AlloyDB for PostgreSQL。

• 驗證來源執行個體中要遷移的資料
• 為 PostgreSQL 執行個體 (例如獨立 PostgreSQL) 的來源連線建立設定檔
• 建立並啟動連續遷移工作
• 確認資料已載入 AlloyDB for PostgreSQL 執行個體
• 將更新即時傳播至 AlloyDB 執行個體

設定和需求

瞭解以下事項後，再點選「Start Lab」按鈕

請詳閱以下操作說明。實驗室活動會計時，且中途無法暫停。點選「Start Lab」後就會開始計時，顯示可使用 Google Cloud 資源的時間。

您將在真正的雲端環境完成實作實驗室活動，而不是模擬或示範環境。為此，我們會提供新的暫時憑證，供您在實驗室活動期間登入及存取 Google Cloud。

為了順利完成這個實驗室，請先確認：

• 可以使用標準的網際網路瀏覽器 (Chrome 瀏覽器為佳)。

注意事項：請使用無痕模式 (建議選項) 或私密瀏覽視窗執行此實驗室，這可以防止個人帳戶和學員帳戶之間的衝突，避免個人帳戶產生額外費用。

• 是時候完成實驗室活動了！別忘了，活動一旦開始將無法暫停。

注意事項：務必使用實驗室專用的學員帳戶。如果使用其他 Google Cloud 帳戶，可能會產生額外費用。

如何開始研究室及登入 Google Cloud 控制台

1. 點選「Start Lab」按鈕。如果實驗室會產生費用，畫面上會出現選擇付款方式的對話方塊。左側的「Lab Details」窗格會顯示下列項目：

   • 「Open Google Cloud console」按鈕
   • 剩餘時間
   • 必須在這個研究室中使用的臨時憑證
   • 完成這個實驗室所需的其他資訊 (如有)

2. 點選「Open Google Cloud console」；如果使用 Chrome 瀏覽器，也能按一下滑鼠右鍵，選取「在無痕視窗中開啟連結」。

   接著，實驗室會啟動相關資源，並開啟另一個分頁，顯示「登入」頁面。

   提示：您可以在不同的視窗中並排開啟分頁。

   注意：如果頁面中顯示「選擇帳戶」對話方塊，請點選「使用其他帳戶」。

3. 如有必要，請將下方的 Username 貼到「登入」對話方塊。

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

   您也可以在「Lab Details」窗格找到 Username。

4. 點選「下一步」。

5. 複製下方的 Password，並貼到「歡迎使用」對話方塊。

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

   您也可以在「Lab Details」窗格找到 Password。

6. 點選「下一步」。

   重要事項：請務必使用實驗室提供的憑證，而非自己的 Google Cloud 帳戶憑證。 注意：如果使用自己的 Google Cloud 帳戶來進行這個實驗室，可能會產生額外費用。

7. 按過後續的所有頁面：

   • 接受條款及細則。
   • 由於這是臨時帳戶，請勿新增救援選項或雙重驗證機制。
   • 請勿申請免費試用。

Google Cloud 控制台稍後會在這個分頁開啟。

注意：如要使用 Google Cloud 產品和服務，請點選「導覽選單」，或在「搜尋」欄位輸入服務或產品名稱。

啟動 Cloud Shell

Cloud Shell 是搭載多項開發工具的虛擬機器，提供永久的 5 GB 主目錄，而且在 Google Cloud 中運作。Cloud Shell 提供指令列存取權，方便您使用 Google Cloud 資源。

1. 點按 Google Cloud 控制台頂端的「啟用 Cloud Shell」圖示 。

2. 系統顯示視窗時，請按照下列步驟操作：

   • 繼續操作 Cloud Shell 視窗。
   • 授權 Cloud Shell 使用您的憑證發出 Google Cloud API 呼叫。

連線建立完成即代表已通過驗證，而且專案已設為您的 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，並支援 Tab 鍵自動完成功能。

3. (選用) 您可以執行下列指令來列出使用中的帳戶：

gcloud auth list

4. 點按「授權」。

輸出內容：

ACTIVE: * ACCOUNT: {{{user_0.username | "ACCOUNT"}}} To set the active account, run: $ gcloud config set account `ACCOUNT`

5. (選用) 您可以使用下列指令來列出專案 ID：

gcloud config list project

輸出內容：

[core] project = {{{project_0.project_id | "PROJECT_ID"}}} 注意：如需 gcloud 的完整說明，請前往 Google Cloud 參閱 gcloud CLI 總覽指南。

工作 1：驗證來源執行個體中要遷移的資料

驗證來源執行個體中的資料

在這個步驟中，您將連線至 pg14-source VM 執行個體的 postgres 資料庫，並驗證資料。

1. 在「導覽選單」() 的「Compute Engine」下方，點選「VM 執行個體」。

2. 在 pg14-source 執行個體的「連線」欄，點選「SSH」，開啟終端機視窗。

3. 使用下列指令啟動 PostgreSQL (psql) 用戶端。

sudo -u postgres psql

4. 您會看到類似下方的 psql 終端機提示。

psql (14.5 (Debian 14.5-1.pgdg110+1)) Type "help" for help.

5. 輸入並執行下列 SQL 指令，查看 postgres 資料庫中與人資相關的資料表。

\dt

6. 執行下列查詢，判斷每個資料表的資料列數量。

select count (*) as countries_row_count from countries; select count (*) as departments_row_count from departments; select count (*) as employees_row_count from employees; select count (*) as jobs_row_count from jobs; select count (*) as locations_row_count from locations; select count (*) as regions_row_count from regions;

7. 來源資料表的資料列數量如下。

名稱	資料列數量
countries	25
departments	27
employees	107
jobs	19
locations	23
regions	4

8. 輸入 \q 結束 psql 用戶端。

9. 輸入 exit 關閉終端機視窗。

工作 2：為獨立 PostgreSQL 資料庫建立資料庫遷移服務的連線設定檔

在這個工作中，您將建立 PostgreSQL 來源執行個體的連線設定檔。

取得 PostgreSQL 來源執行個體的連線和部署資訊

在這個步驟中，您將找出要遷移至 AlloyDB 的來源資料庫執行個體內部 IP 位址。

1. 在「導覽選單」() 的「Compute Engine」下方，點選「VM 執行個體」。

2. 找到 pg14-source 執行個體的那一行。

3. 複製其內部 IP 的值 (例如 10.128.15.208)。

為 PostgreSQL 來源執行個體建立新的連線設定檔

連線設定檔會儲存來源資料庫執行個體 (例如獨立 PostgreSQL) 的資訊，供資料庫遷移服務使用，將來源資料遷移至目的地 AlloyDB for PostgreSQL 資料庫執行個體。連線設定檔建立後，可重複用於各項遷移工作。

在這個步驟中，您將建立 PostgreSQL 來源執行個體的新連線設定檔。

1. 在 Google Cloud 控制台的「導覽選單」()，點選「查看所有產品」，在「資料庫」部分點選「資料庫遷移」>「連線設定檔」。

2. 點選「+ 建立設定檔」。

3. 在「設定檔角色」部分，選取「來源」。

4. 在「資料庫引擎」部分，選取「PostgreSQL」。

5. 在「連線設定檔名稱」部分，輸入 pg14-source。

6. 在「區域」部分，選取「」。

7. 在「定義連線設定」下方，點選「定義」

8. 在「主機名稱或 IP 位址」部分，輸入前一個工作中複製的 PostgreSQL 來源執行個體內部 IP (例如 10.128.15.208)

9. 在「通訊埠」部分，輸入 5432。

10. 在「使用者名稱」欄位輸入 postgres。

11. 在「密碼」欄位輸入 Change3Me。

12. 其他項目請保留預設值。

13. 點選「儲存」。

14. 點選「建立」。

連線設定檔清單會顯示新的連線設定檔 pg14-source。

12. 點選「Check my progress」，確認目標已達成。 建立 PostgreSQL 來源執行個體的連線設定檔。

工作 3：建立並啟動連續遷移工作

建立新的遷移工作時，第一步是使用先前建立的連線設定檔，定義來源資料庫執行個體。完成後，您需要建立新的目的地資料庫執行個體，並設定來源與目的地執行個體之間的連線。

在這項工作中，您將透過遷移工作介面，建立新的 AlloyDB for PostgreSQL 叢集，並設為 PostgreSQL 來源執行個體連續遷移工作的目的地。

建立新的連續遷移工作

在這個步驟中，您將建立新的連續遷移工作。

1. 在 Google Cloud 控制台的「導覽選單」()，點選「查看所有產品」，在「資料庫」部分點選「資料庫遷移」>「遷移工作」。

2. 點選「+ 建立遷移工作」。

3. 在「遷移工作名稱」部分，輸入 postgres-to-alloydb。

4. 在「來源資料庫引擎」部分，選取「PostgreSQL」。

5. 在「目的地資料庫引擎」部分，選取「AlloyDB for PostgreSQL」。

6. 在「目的地區域」部分，選取「」。

7. 目前，由 PostgreSQL 至 AlloyDB 的遷移工作類型只有「連續」選項。

8. 其他項目請保留預設值。

9. 點選「儲存並繼續」。

定義來源執行個體

在這個步驟中，您將定義遷移工作的來源執行個體。

1. 在「選取來源連線設定檔」部分，選取您在幾個步驟前建立的 pg14-source 連線設定檔。

2. 點選「儲存並繼續」。

建立目的地執行個體

在這個步驟中，DMS 精靈會代您建立 AlloyDB 叢集和執行個體。

1. 在「目的地叢集類型」部分，已選取「新叢集」選項。

2. 點選「繼續」，前往「檢查叢集設定」。

3. 在「叢集 ID」部分輸入 alloydb-target-cluster。

4. 在「密碼」欄位輸入 Change3Me。

5. 在「網路」部分選取「peering-network」。

6. 按一下「繼續」。

7. 在「執行個體 ID」部分輸入 alloydb-target-instance。

8. 在「機型」部分選取 2 個 vCPU，16 GB。

9. 點選「儲存並繼續」。

10. 在彈出式視窗中，點選「建立目的地並繼續」即可繼續。

11. 在建立 AlloyDB 執行個體和叢集期間，您可以從「連線方式」清單中選擇「虛擬私有雲對接」。

12. 請等待叢集和執行個體建立完成。資料庫可用後，即可點選「設定並繼續」連結。

13. 點選「設定並繼續」。

14. 在「選取要遷移的物件」頁面的「要遷移的資料庫」下方，選取「所有資料庫」。

15. 點選「儲存並繼續」。

測試並開始執行連續遷移工作

在這個步驟中，您將測試並開始執行遷移工作。

1. 資料庫遷移服務精靈現在會顯示「測試和建立遷移工作」步驟。

2. 點選「測試工作」。

3. 測試成功後，點選「建立及啟動工作」。

注意：您必須點選「建立及啟動工作」，工作才會開始。另一個連結只會建立並儲存工作詳細資料。

如果系統提示您確認操作，請點選「建立並啟動」。

查看連續遷移工作狀態

在這個步驟中，您將確認遷移工作正在執行。

1. 在 Google Cloud 控制台的「導覽選單」()，點選「查看所有產品」，在「資料庫」部分點選「資料庫遷移」>「遷移工作」。

2. 點選遷移工作「postgres-to-alloydb」，查看其詳細資料頁面。

3. 查看遷移工作狀態。

• 如果尚未啟動工作，其狀態會顯示為「尚未啟動」，您可以選擇啟動或刪除工作。
• 啟動工作後，狀態會顯示為「啟動中」，然後轉為「執行中」/「正在執行完整 dump 作業」，表示正在執行初始資料庫轉儲作業。
• 初始載入作業完成且 DMS 可持續運作後，工作狀態會變成「正在執行 CDC 作業」。

工作狀態變成「正在執行 CDC 作業」時，請繼續下一個工作。

工作 4：確認資料已載入 AlloyDB for PostgreSQL 執行個體

檢查 AlloyDB for PostgreSQL 執行個體

1. 在 Cloud 控制台的「導覽選單」()，點選「查看所有產品」>「資料庫」>「AlloyDB」>「叢集」，即可查看叢集詳細資料。

2. 叢集名稱為 alloydb-target-cluster，執行個體名稱為 alloydb-target-cluster-primary。

3. 請記下執行個體區段中的私人 IP 位址。將「私人 IP」位址複製到文字檔，以便在後續步驟中貼上該值。

4. 在「導覽選單」() 的「Compute Engine」下方，點選「VM 執行個體」。

5. 在「連線」欄中，點選「alloydb-client」執行個體的「SSH」，開啟終端機視窗。

6. 將下列指令的 ALLOYDB_ADDRESS 替換為 AlloyDB 執行個體的私人 IP 位址，設定環境變數。

export ALLOYDB=ALLOYDB_ADDRESS

7. 執行下列指令，將 AlloyDB 執行個體的私人 IP 位址儲存至 AlloyDB 用戶端 VM，確保操作實驗室期間都能使用。

echo $ALLOYDB > alloydbip.txt

8. 連線至 psql 用戶端，然後執行下列查詢，確認五個來源資料表已經在 AlloyDB 執行個體中。系統會提示您提供建立叢集時指定的 postgres 使用者密碼 (Change3Me)。

psql -h $ALLOYDB -U postgres \dt List of relations Schema | Name | Type | Owner --------+-------------+-------+--------------------- public | countries | table | alloydbexternalsync public | departments | table | alloydbexternalsync public | employees | table | alloydbexternalsync public | jobs | table | alloydbexternalsync public | locations | table | alloydbexternalsync public | regions | table | alloydbexternalsync (6 rows)

9. 執行下列查詢，判斷已遷移資料表的資料列數量。這些值會與查詢來源執行個體的輸出內容相符。

select count (*) as countries_row_count from countries; select count (*) as departments_row_count from departments; select count (*) as employees_row_count from employees; select count (*) as jobs_row_count from jobs; select count (*) as locations_row_count from locations; select count (*) as regions_row_count from regions;

10. 目標資料表的資料列數量如下。

名稱	資料列數量
countries	25
departments	27
employees	107
jobs	19
locations	23
regions	4

11. 執行下列查詢，驗證 regions 資料表中的資料。

select region_id, region_name from regions; region_id | region_name -----------+------------------------ 1 | Europe 2 | Americas 3 | Asia 4 | Middle East and Africa (4 rows) .

工作 5：將更新即時傳播至 AlloyDB 執行個體

1. 由於資料庫遷移服務工作設定為持續更新，因此您對來源執行個體所做的任何更新，都會套用至 AlloyDB 目標。

2. 在「導覽選單」() 的「Compute Engine」下方，點選「VM 執行個體」。

3. 在 pg14-source 執行個體的「連線」欄，點選「SSH」，開啟終端機視窗。

4. 使用下列指令啟動 PostgreSQL (psql) 用戶端。

sudo -u postgres psql

5. 您會看到 psql 終端機提示。輸入並執行下列 SQL 指令，將一列資料新增至 regions 資料表。

insert into regions values (5, 'Oceania');

6. 確認資料列已插入本機資料庫。

select region_id, region_name from regions; region_id | region_name -----------+------------------------ 1 | Europe 2 | Americas 3 | Asia 4 | Middle East and Africa 5 | Oceania (5 rows)

查看 AlloyDB for PostgreSQL 執行個體中的資料

1. 返回 alloydb-client 的終端機殼層。psql 用戶端仍在開啟狀態。執行下列查詢，確認 Oceania 資料列已新增至目標 AlloyDB 執行個體。

select region_id, region_name from regions; region_id | region_name -----------+------------------------ 1 | Europe 2 | Americas 3 | Asia 4 | Middle East and Africa 5 | Oceania (5 rows)

2. 點選「Check my progress」，確認目標已達成。 測試資料的持續遷移作業

恭喜！

您已成功使用資料庫遷移服務的連續工作，將虛擬機器中執行的獨立 PostgreSQL 資料庫，遷移至 AlloyDB for PostgreSQL。

使用手冊上次更新日期：2025 年 2 月 14 日

實驗室上次測試日期：2025 年 2 月 14 日

Copyright 2025 Google LLC 保留所有權利。Google 和 Google 標誌是 Google LLC 的商標，其他公司和產品名稱則有可能是其關聯公司的商標。