教學課程：使用移轉服務從適用於 PostgreSQL 的 Azure 資料庫 - 單一伺服器移轉至彈性伺服器

適用於： 適用於 PostgreSQL 的 Azure 資料庫 - 彈性伺服器

使用 Azure 入口網站，您可以將 [適用於 PostgreSQL 的 Azure 資料庫 - 單一伺服器] 的執行個體移轉至 [適用於 PostgreSQL 的 Azure 資料庫 - 彈性伺服器]。 在本教學課程中，我們會使用 Azure 入口網站，將範例資料庫從適用於 PostgreSQL 的 Azure 資料庫單一伺服器移轉至 PostgreSQL 彈性伺服器。

• 設定適用於 PostgreSQL 的 Azure 資料庫彈性伺服器
• 設定移轉工作
• 監視移轉
• 取消移轉
• 移轉後

入口網站

您可以使用 Azure 入口網站進行移轉。

離線

必要條件 (離線)

在適用於 PostgreSQL 的 Azure 資料庫中使用移轉服務開始進行移轉之前，您必須滿足下列適用於離線移轉案例的必要條件。

驗證來源版本

來源 PostgreSQL 版本應該是 >= 9.5。 如果來源 PostgreSQL 版本小於 9.5，請先將來源 PostgreSQL 版本升級至 9.5 或更新版本，再進行移轉。

目標設定

• 開始移轉流程之前，必須先在 Azure 中部署並正確設定適用於 PostgreSQL 的 Azure 資料庫彈性伺服器。

• 為適用於 PostgreSQL 的 Azure 資料庫選擇的 SKU 應與來源資料庫的規格對應，以確保相容性和適當的效能。

• 關於如何建立新的適用於 PostgreSQL 的 Azure 資料庫，如需詳細指示，請參閱下列連結：快速入門：建立伺服器。

網路設定

網路設定對於讓移轉服務能夠正常運作至關重要。 請確定來源 PostgreSQL 伺服器可以與目標適用於 PostgreSQL 的 Azure 資料庫伺服器通訊。 下列網路設定對於成功移轉而言非常重要。

如需網路設定的相關資訊，請參閱移轉服務的網路指南。

啟用延伸模組

若要確保能在適用於 PostgreSQL 的 Azure 資料庫中使用移轉服務成功移轉，您可能需要驗證來源 PostgreSQL 執行個體的延伸模組。 延伸模組會提供應用程式可能需要的其他功能與特性。 起始移轉流程之前，請務必驗證來源 PostgreSQL 執行個體上的延伸模組。

在目標適用於 PostgreSQL 的 Azure 資料庫彈性伺服器上，啟用來源 PostgreSQL 執行個體中識別出的支援延伸模組。

如需延伸模組的詳細資訊，請參閱適用於 PostgreSQL 的 Azure 資料庫中的延伸模組。

注意

當 shared_preload_libraries 參數有任何變更時，就需要重新啟動。

檢查伺服器參數

這些參數不會自動移轉至目標環境，必須手動設定。

• 透過存取 Azure 入口網站中的 [伺服器參數] 區段，並據以手動更新參數值，讓來源 PostgreSQL 資料庫與適用於 PostgreSQL 的 Azure 資料庫有相符的伺服器參數值。

• 儲存參數變更，並視需要重新啟動適用於 PostgreSQL 的 Azure 資料庫彈性伺服器以套用新設定。

在目標中停用高可用性 (可靠性) 和讀取複本

• 請務必在目標環境中停用高可用性 (可靠性) 和讀取複本。 請在移轉完成後，才啟用這些功能。

• 透過遵循這些指導方針，您可以協助確保移轉流程順暢進行，而不會因為高可用性和讀取複本而增添變數。 移轉完成且資料庫穩定之後，便可以繼續啟用這些功能，以增強 Azure 中資料庫環境的可用性和可擴縮性。

設定適用於 PostgreSQL 的 Azure 資料庫彈性伺服器

• 建立目標彈性伺服器。 如需引導式步驟，請參閱使用入口網站建立適用於 PostgreSQL 的 Azure 資料庫彈性伺服器。

• 允許清單延伸模組，其程式庫必須在伺服器啟動時載入。 在起始移轉之前，延伸模組必須位於允許清單上。

• 檢查資料庫的資料表之間的資料分佈是否扭曲，其中大部分的資料都存在於單一 (或數個) 資料表中。 如果有所扭曲，移轉速度可能會比預期更慢。 在此案例中，可藉由平行移轉大型資料表來加快移轉速度。

設定移轉工作

移轉服務會在 Azure 入口網站上提供簡單的精靈型體驗。 以下說明如何開始：

1. 開啟 Web 瀏覽器，然後移至入口網站。 若要登入，請輸入認證。 預設檢視是您的服務儀表板。

2. 移至您的適用於 PostgreSQL 的 Azure 資料庫彈性伺服器目標。

3. 在彈性伺服器 [概觀] 索引標籤的左側功能表上，向下捲動至 [移轉] 並加以選取。

   

4. 選取 [建立] 按鈕，開始從單一伺服器移轉至彈性伺服器。 如果這是您第一次使用移轉服務，會出現空白方格，並出現提示以開始您的第一次移轉。

   

   如果您已建立對彈性伺服器目標的移轉，此方格會包含已嘗試從單一伺服器移轉至此目標的移轉相關資訊。

5. 您會瀏覽一系列以精靈為基礎的索引標籤，以從不同的可能來源建立移轉至此彈性伺服器目標。 根據預設，來源伺服器類型會設定為適用於 PostgreSQL 的 Azure 資料庫單一伺服器，這是我們在此案例中感興趣的伺服器類型。

或者，您可以從適用於 PostgreSQL 的 Azure 資料庫單一伺服器起始移轉程序。

1. 開啟 Web 瀏覽器，然後移至入口網站。 若要登入，則必須輸入認證。 預設檢視是您的服務儀表板。

2. 選取 [單一伺服器] 時，您可以在 [概觀] 索引標籤中觀察與移轉相關的橫幅。選取 [立即移轉] 以開始使用。

   

3. 系統會將您導向具有兩個選項的頁面。 如果您已經建立彈性伺服器，且想要使用該伺服器作為目標，請選擇 [選取現有項目]，然後選取對應的訂用帳戶、資源群組和伺服器名稱詳細資料。 選取之後，選取 [前往移轉精靈]，然後遵循 [設定] 區段底下的指示。

   

4. 如果您選擇建立新的彈性伺服器，則選取 [建立新項目]，然後選取 [前往建立精靈]。 此動作會將您導向彈性伺服器建立流程，並部署彈性伺服器。

   

部署彈性伺服器之後，請遵循設定移轉工作下的步驟 3 到 5。

設定

第一個索引標籤是 [設定]。 萬一錯過，請在起始移轉之前，將必要的延伸模組列入允許清單，如設定適用於 PostgreSQL 的 Azure 資料庫彈性伺服器中所述。

移轉名稱是至此彈性伺服器目標的每個移轉的唯一識別碼。 此欄位只接受英數字元，不接受任何特殊字元，但底線 (_) 和連字號 (-) 除外。 名稱必須以英數字元開頭。 目標伺服器的名稱也必須是唯一，因為不會有兩個至相同彈性伺服器目標的移轉可以具有相同名稱。

來源伺服器類型表示來源。 在此案例中，其為適用於 PostgreSQL 的 Azure 資料庫單一伺服器。

移轉選項可讓您在觸發移轉前執行驗證。 您可以挑選下列任何選項。

• 驗證：檢查您的伺服器和資料庫整備程度，以移轉至目標。
• 移轉：略過驗證並開始移轉。
• 驗證並移轉：在觸發移轉之前執行驗證。 僅在沒有驗證失敗時，才會觸發移轉。

在執行移轉之前選擇 [驗證] 或 [驗證並移轉] 選項，來執行移轉前驗證向來是很好的做法。

移轉模式可讓您在線上移轉與離線移轉之間進行選擇，在此案例中，必須將其設定為 [離線]。

選取 [下一步: 選取執行階段伺服器] 按鈕。

執行階段伺服器

移轉執行階段伺服器是適用於 PostgreSQL 的 Azure 資料庫中的移轉服務內的特殊功能，旨在移轉期間作為中繼伺服器使用。 其是單獨的適用於 PostgreSQL 的 Azure 資料庫 - 彈性伺服器執行個體，不是目標伺服器，但可用來協助從只能透過私人網路存取的來源環境中移轉資料庫。

如需執行階段伺服器的詳細資訊，請參閱移轉執行階段伺服器。

選取 [下一步：連線至來源] 按鈕。

連線至來源

[來源] 區段會提示您提供與單一伺服器 (資料庫來源) 相關的詳細資料。

選取 [訂用帳戶] 和 [資源群組] 之後，伺服器名稱的下拉式清單會顯示該資源群組跨區域下的單一伺服器。 選取要從中移轉資料庫的來源。 您可以將資料庫從單一伺服器遷移至相同區域中的目標彈性伺服器。 僅印度、中國和阿拉伯聯合大公國的伺服器支援跨區域移轉。

選擇單一伺服器來源之後，即會自動填入 [位置] 和 [PostgreSQL 版本] 方塊。 請確定您會提供系統管理員角色的認證，因為移轉服務必須具備該認證，才能成功移轉資料庫。

填妥所有欄位之後，請選取 [連線至來源] 連結。 這會驗證輸入的來源伺服器詳細資料是否正確，以及其是否可連線至來源伺服器。

選取 [下一步: 選取移轉目標] 按鈕以繼續。

選取移轉目標

[選取移轉目標] 區段會顯示彈性伺服器目標的中繼資料，例如訂用帳戶、資源群組、伺服器名稱、位置和 PostgreSQL 版本。

針對驗證方法和所有驗證相關欄位選擇適當值。 請確定提供的身分識別是目標伺服器中系統管理員使用者的身分識別。 填寫所有必要資訊之後，選取 [連線至目標] 連結。 這會驗證輸入的目標伺服器詳細資料是否正確，以及是否可連線至目標伺服器。

選取 [下一步: 選取要移轉的資料庫] 按鈕，以選取要移轉的資料庫。

選取要移轉的資料庫

在此索引標籤下，單一伺服器內有使用者資料庫的清單。 您可以在單一移轉嘗試中，選取並移轉最多八個資料庫。 如果有八個以上的使用者資料庫，則會對下一組資料庫重複來源和目標伺服器之間的移轉流程。 系統會覆寫目標伺服器上具有完全相同名稱的所選取資料庫。

選取 [下一步: 摘要] 按鈕以檢閱詳細資料。

摘要

[摘要] 索引標籤會摘要說明建立驗證或移轉的所有詳細資料。 檢閱詳細資料，然後選取 [開始驗證和移轉] 按鈕。

監視移轉入口網站

當您開始移轉之後，通知會在幾秒鐘內顯示，表示已成功驗證或建立移轉。 系統會自動將您重新導向至彈性伺服器的 [移轉] 頁面。 此處有最近所建立驗證或移轉的新項目。

顯示移轉的方格具有下列資料行：名稱、狀態、移轉模式、移轉類型、來源伺服器、來源伺服器類型、資料庫、開始時間和持續期間。 項目會以開始時間的遞減順序顯示，最上方為最近的項目。

您可以使用 [重新整理] 按鈕，重新整理驗證或移轉的狀態。

您也可以在方格中選取某個特定移轉的名稱，以查看相關聯的詳細資料。

當建立驗證或移轉時，其會移至 InProgress 狀態和 PerformingPreRequisiteSteps 子狀態。 此工作流程會花 2 到 3 分鐘的時間來設定移轉基礎結構和網路連線。

讓我們看看如何監視每個移轉選項的移轉。

Validate

PerformingPreRequisiteSteps 子狀態完成之後，驗證會移至 Validation in Progress 的子狀態，並將在來源和目標伺服器上完成檢查以評估移轉的整備程度。

如果所有驗證都處於 Succeeded 或 Warning 狀態，驗證就會移至 Succeeded 狀態。

驗證方格具有下列資訊：

• [執行個體的驗證詳細資料] 和 [資料庫的驗證詳細資料] 區段，表示用來檢查移轉整備程度的驗證規則。
• 驗證名稱：每個特定驗證規則的名稱。
• 驗證狀態：代表每個規則的結果，而且可以是這三個值中的任何一個：
  • 成功：如果沒有找到錯誤。
  • 失敗：如果有驗證錯誤。
  • 警告：如果有驗證錯誤。
• 持續期間：驗證作業所花費的時間。
• 開始時間 (UTC) 和結束時間 (UTC)：驗證作業的開始和結束時間，以 UTC 表示。

如果驗證發生任何錯誤，「驗證狀態」就會移至 Failed 狀態。 選取驗證失敗的 [驗證名稱] 或 [資料庫名稱]，而展開窗格會提供詳細資料和矯正措施，以避免發生此錯誤。

移轉

PerformingPreRequisiteSteps 子狀態完成之後，移轉會在進行資料庫複製期間進入正在移轉資料子狀態。 移轉完成的時間取決於您要移轉的資料庫大小和形狀。 如果資料大多平均分散到所有資料表，則移轉會很快。 扭曲的資料表大小需要相對較長的時間。

當您在移轉中選取任何資料庫時，就會出現展開窗格。 其具備所有資料表計數 (已複製、已排入佇列、正在複製和錯誤)，以及資料庫移轉狀態。

當 Migrating Data 狀態成功完成，移轉就會移至 Succeeded 狀態。 如果 [移轉資料] 狀態發生問題，則移轉會進入 [已失敗] 狀態。

移轉移至 Succeeded 狀態後，即表示結構描述和資料從單一伺服器移轉至彈性伺服器的目標已完成。 您可以重新整理頁面以檢查進度。

驗證和移轉

在此選項中，移轉開始之前會先執行驗證。 PerformingPreRequisiteSteps 子狀態完成之後，工作流程會移至 Validation in Progress 的子狀態。

• 如果驗證發生錯誤，移轉會進入 Failed 狀態。
• 如果驗證完成且沒有任何錯誤，則會開始移轉，且工作流程會移至 Migrating Data 的子狀態。

一旦作業完成，您就可以看到驗證和移轉的結果。

線上存取

必要條件 (線上)

在使用適用於 PostgreSQL 的 Azure 資料庫中的移轉服務開始進行移轉之前，請先滿足下列適用於離線移轉案例的必要條件。

驗證來源版本

來源 PostgreSQL 版本應該是 >= 9.5。 如果來源 PostgreSQL 版本小於 9.5，請先將來源 PostgreSQL 版本升級至 9.5 或更新版本，再進行移轉。

設定線上移轉參數

針對線上移轉，應在來源 PostgreSQL 伺服器的 [複寫設定] 下將複製支援設為 [邏輯]。 此外，伺服器參數 max_wal_senders 和 max_replication_slots 值應該大於需要移轉的資料庫數目。 您可以在 Azure 入口網站中的 [設定] -> [伺服器參數] 下設定參數，或使用下列命令在命令列中進行設定：

• ALTER SYSTEM SET wal_level = 邏輯;
• ALTER SYSTEM SET max_wal_senders = number of databases to migrate + 1;
• ALTER SYSTEM SET max_replication_slots = number of databases to migrate + 1;

請確定沒有 長時間執行的交易。 長時間執行的交易不允許建立複寫位置。 如果認可或回復所有長時間執行的交易，複寫位置的建立將會成功。 完成所有線上移轉必要條件之後，您必須重新啟動來源 PostgreSQL 伺服器。

注意

針對使用適用於 PostgreSQL 的 Azure 資料庫單一伺服器進行線上移轉，Azure 複寫支援會在 Azure 入口網站中單一伺服器頁面的 [復寫設定] 底下的 [邏輯]。

若要防止連線移轉用盡可儲存記錄的儲存體，請確定您有足夠的資料表空間使用已佈建的受控磁碟。 若要達成此目的，請在移轉期間停用彈性伺服器上的伺服器參數 azure.enable_temp_tablespaces_on_local_ssd，並在移轉之後將其還原為原始狀態。

設定目標

• 移轉前必須先在 Azure 中設定適用於 PostgreSQL 的 Azure 資料庫。

• 為適用於 PostgreSQL 的 Azure 資料庫選擇的 SKU 應與來源資料庫的規格對應，以確保相容性和適當的效能。

• 關於如何建立新的適用於 PostgreSQL 的 Azure 資料庫，如需詳細指示，請參閱下列連結：快速入門：建立伺服器。

• 伺服器參數 max_replication_slots 應該大於需要移轉的資料庫數目。 可以在 Azure 入口網站中的 [設定] -> [伺服器參數] 下設定參數，或使用下列命令在命令列中進行設定：

• ALTER SYSTEM SET max_replication_slots = number of databases to migrate + 1;

設定網路

網路設定對於讓移轉服務能夠正常運作至關重要。 請確定來源 PostgreSQL 伺服器可以與目標適用於 PostgreSQL 的 Azure 資料庫伺服器通訊。 下列網路設定對於成功移轉而言非常重要。

如需網路設定的相關資訊，請參閱移轉服務的網路指南。

啟用延伸模組

若要確保能在適用於 PostgreSQL 的 Azure 資料庫中使用移轉服務成功移轉，您可能需要驗證來源 PostgreSQL 執行個體的延伸模組。 延伸模組會提供應用程式可能需要的其他功能與特性。 起始移轉流程之前，請務必驗證來源 PostgreSQL 執行個體上的延伸模組。

在目標適用於 PostgreSQL 的 Azure 資料庫彈性伺服器上，啟用來源 PostgreSQL 執行個體中識別出的支援延伸模組。

如需延伸模組的詳細資訊，請參閱適用於 PostgreSQL 的 Azure 資料庫中的延伸模組。

注意

當 shared_preload_libraries 參數有任何變更時，就需要重新啟動。

伺服器參數

這些參數不會自動移轉至目標環境，必須手動設定。

• 藉由存取 Azure 入口網站中的 [伺服器參數] 區段，並據以手動更新參數值，讓來源 PostgreSQL 資料庫與適用於 PostgreSQL 的 Azure 資料庫有相符的伺服器參數值。

• 儲存參數變更，並視需要重新啟動適用於 PostgreSQL 的 Azure 資料庫以套用新的設定。

在目標中停用高可用性 (可靠性) 和讀取複本

• 請務必要在目標環境中停用高可用性 (可靠性)和讀取複本。 請在移轉完成後，才啟用這些功能。

• 藉由遵循這些指導方針，可協助確保移轉程序順暢進行，而不會因為 HA 和讀取複本而增添變數。 移轉完成且資料庫穩定之後，便可以繼續啟用這些功能，以增強 Azure 中資料庫環境的可用性和可擴縮性。

注意

某些限制適用於連線移轉，而這些限制記載在這裡。 請確定您的資料庫符合執行連線移轉的規範。

設定適用於 PostgreSQL 的 Azure 資料庫彈性伺服器

• 建立目標彈性伺服器。 如需引導式步驟，請參閱使用入口網站建立適用於 PostgreSQL 的 Azure 資料庫彈性伺服器。

• 允許清單延伸模組，其程式庫必須在伺服器啟動時載入。 在起始移轉之前，延伸模組必須位於允許清單上。

• 檢查資料庫的資料表之間的資料分佈是否扭曲，其中大部分的資料都存在於單一 (或數個) 資料表中。 如果有所扭曲，移轉速度可能會比預期更慢。 在此案例中，可藉由平行移轉大型資料表來加快移轉速度。

設定移轉工作

移轉服務會在 Azure 入口網站上提供簡單的精靈型體驗。 以下說明如何開始：

1. 開啟 Web 瀏覽器，然後移至入口網站。 若要登入，請輸入認證。 預設檢視是您的服務儀表板。

2. 移至您的適用於 PostgreSQL 的 Azure 資料庫彈性伺服器目標。

3. 在彈性伺服器 [概觀] 索引標籤的左側功能表上，向下捲動至 [移轉] 並加以選取。

   

4. 選取 [建立] 按鈕，開始從單一伺服器移轉至彈性伺服器。 如果這是您第一次使用移轉服務，會出現空白方格，並出現提示以開始您的第一次移轉。

   

   如果您已建立對彈性伺服器目標的移轉，此方格會包含已嘗試從單一伺服器移轉至此目標的移轉相關資訊。

5. 您會瀏覽一系列以精靈為基礎的索引標籤，以從不同的可能來源建立移轉至此彈性伺服器目標。 根據預設，來源伺服器類型會設定為適用於 PostgreSQL 的 Azure 資料庫單一伺服器，這是我們在此案例中感興趣的伺服器類型。

或者，您可以從適用於 PostgreSQL 的 Azure 資料庫單一伺服器起始移轉程序。

1. 開啟 Web 瀏覽器，然後移至入口網站。 若要登入，則必須輸入認證。 預設檢視是您的服務儀表板。

2. 選取 [單一伺服器] 時，您可以在 [概觀] 索引標籤中觀察與移轉相關的橫幅。選取 [立即移轉] 以開始使用。

   

3. 系統會將您導向具有兩個選項的頁面。 如果您已經建立彈性伺服器，且想要使用該伺服器作為目標，請選擇 [選取現有項目]，然後選取對應的訂用帳戶、資源群組和伺服器名稱詳細資料。 選取之後，選取 [前往移轉精靈]，然後遵循 [設定] 區段底下的指示。

   

4. 如果您選擇建立新的彈性伺服器，則選取 [建立新項目]，然後選取 [前往建立精靈]。 此動作會將您導向彈性伺服器建立流程，並部署彈性伺服器。

   

部署彈性伺服器之後，請遵循設定移轉工作下的步驟 3 到 5。

設定

第一個索引標籤是 [設定]。 萬一錯過，請在起始移轉之前，將必要的延伸模組列入允許清單，如設定適用於 PostgreSQL 的 Azure 資料庫彈性伺服器中所述。

移轉名稱是至此彈性伺服器目標的每個移轉的唯一識別碼。 此欄位只接受英數字元，不接受任何特殊字元，但底線 (_) 和連字號 (-) 除外。 名稱必須以英數字元開頭。 目標伺服器的名稱也必須是唯一，因為不會有兩個至相同彈性伺服器目標的移轉可以具有相同名稱。

來源伺服器類型表示來源。 在此案例中，其為適用於 PostgreSQL 的 Azure 資料庫單一伺服器。

移轉選項可讓您在觸發移轉前執行驗證。 您可以挑選下列任何選項。

• 驗證：檢查您的伺服器和資料庫整備程度，以移轉至目標。
• 移轉：略過驗證並開始移轉。
• 驗證並移轉：在觸發移轉之前執行驗證。 僅在沒有驗證失敗時，才會觸發移轉。

在執行移轉之前選擇 [驗證] 或 [驗證並移轉] 選項，來執行移轉前驗證向來是很好的做法。

移轉模式可讓您在線上移轉與離線移轉之間進行選擇，在此案例中，必須將其設定為 [線上]。

選取 [線上] 移轉模式時，必須在來源單一伺服器中開啟邏輯複寫。 如果未開啟，移轉服務會自動在來源單一伺服器上開啟邏輯複寫。 您也可以選取單一伺服器資源功能表中 [設定] 底下的 [複寫] 項目，然後將 [Azure 複寫支援] 設定為 [邏輯]，藉以手動設定複寫。 任一種方法都會重新啟動來源單一伺服器。

選取 [下一步: 選取執行階段伺服器] 按鈕。

執行階段伺服器

移轉執行階段伺服器是適用於 PostgreSQL 的 Azure 資料庫中的移轉服務內的特殊功能，旨在移轉期間作為中繼伺服器使用。 其是單獨的適用於 PostgreSQL 的 Azure 資料庫 - 彈性伺服器執行個體，不是目標伺服器，但可用來協助從只能透過私人網路存取的來源環境中移轉資料庫。

如需執行階段伺服器的詳細資訊，請參閱移轉執行階段伺服器。

選取 [下一步：連線至來源] 按鈕。

連線至來源

[來源] 區段會提示您提供與單一伺服器 (資料庫來源) 相關的詳細資料。

選取 [訂用帳戶] 和 [資源群組] 之後，伺服器名稱的下拉式清單會顯示該資源群組跨區域下的單一伺服器。 選取要從中移轉資料庫的來源。 您可以將資料庫從單一伺服器遷移至相同區域中的目標彈性伺服器。 僅印度、中國和阿拉伯聯合大公國的伺服器支援跨區域移轉。

選擇單一伺服器來源之後，即會自動填入 [位置] 和 [PostgreSQL 版本] 方塊。 請確定您會提供系統管理員角色的認證，因為移轉服務必須具備該認證，才能成功移轉資料庫。

填妥所有欄位之後，請選取 [連線至來源] 連結。 這會驗證輸入的來源伺服器詳細資料是否正確，以及其是否可連線至來源伺服器。

選取 [下一步: 選取移轉目標] 按鈕以繼續。

選取移轉目標

[選取移轉目標] 區段會顯示彈性伺服器目標的中繼資料，例如訂用帳戶、資源群組、伺服器名稱、位置和 PostgreSQL 版本。

針對驗證方法和所有驗證相關欄位選擇適當值。 請確定提供的身分識別是目標伺服器中系統管理員使用者的身分識別。 填寫所有必要資訊之後，選取 [連線至目標] 連結。 這會驗證輸入的目標伺服器詳細資料是否正確，以及是否可連線至目標伺服器。

選取 [下一步: 選取要移轉的資料庫] 按鈕，以選取要移轉的資料庫。

選取要移轉的資料庫

在此索引標籤下，單一伺服器內有使用者資料庫的清單。 您可以在單一移轉嘗試中，選取並移轉最多八個資料庫。 如果有八個以上的使用者資料庫，則會對下一組資料庫重複來源和目標伺服器之間的移轉流程。 系統會覆寫目標伺服器上具有完全相同名稱的所選取資料庫。

選取 [下一步: 摘要] 按鈕以檢閱詳細資料。

摘要

[摘要] 索引標籤會摘要說明建立驗證或移轉的所有詳細資料。 檢閱詳細資料，然後選取 [開始驗證和移轉] 按鈕。

監視移轉入口網站

當您開始移轉之後，通知會在幾秒鐘內顯示，表示已成功驗證或建立移轉。 系統會自動將您重新導向至彈性伺服器的 [移轉] 頁面。 此處有最近所建立驗證或移轉的新項目。

顯示移轉的方格具有下列資料行：名稱、狀態、移轉模式、移轉類型、來源伺服器、來源伺服器類型、資料庫、開始時間和持續期間。 項目會以開始時間的遞減順序顯示，最上方為最近的項目。

您可以使用 [重新整理] 按鈕，重新整理驗證或移轉的狀態。

您也可以在方格中選取某個特定移轉的名稱，以查看相關聯的詳細資料。

當建立驗證或移轉時，其會移至 InProgress 狀態和 PerformingPreRequisiteSteps 子狀態。 此工作流程會花 2 到 3 分鐘的時間來設定移轉基礎結構和網路連線。

讓我們看看如何監視每個移轉選項的移轉。

Validate

PerformingPreRequisiteSteps 子狀態完成之後，驗證會移至 Validation in Progress 的子狀態，並將在來源和目標伺服器上完成檢查以評估移轉的整備程度。

如果所有驗證都處於 Succeeded 或 Warning 狀態，驗證就會移至 Succeeded 狀態。

驗證方格具有下列資訊：

• [執行個體的驗證詳細資料] 和 [資料庫的驗證詳細資料] 區段，表示用來檢查移轉整備程度的驗證規則。
• 驗證名稱：每個特定驗證規則的名稱。
• 驗證狀態：代表每個規則的結果，而且可以是這三個值中的任何一個：
  • 成功：如果沒有找到錯誤。
  • 失敗：如果有驗證錯誤。
  • 警告：如果有驗證錯誤。
• 持續期間：驗證作業所花費的時間。
• 開始時間 (UTC) 和結束時間 (UTC)：驗證作業的開始和結束時間，以 UTC 表示。

如果驗證發生任何錯誤，「驗證狀態」就會移至 Failed 狀態。 選取驗證失敗的 [驗證名稱] 或 [資料庫名稱]，而展開窗格會提供詳細資料和矯正措施，以避免發生此錯誤。

移轉

PerformingPreRequisiteSteps 子狀態完成之後，移轉會在進行資料庫複製期間進入正在移轉資料子狀態。 移轉完成的時間取決於您要移轉的資料庫大小和形狀。 如果資料大多平均分散到所有資料表，則移轉會很快。 扭曲的資料表大小需要相對較長的時間。

當您在移轉中選取任何資料庫時，就會出現展開窗格。 其具備所有資料表計數 (已複製、已排入佇列、正在複製和錯誤)，以及資料庫移轉狀態。

當 Migrating Data 狀態成功完成，移轉就會移至 Succeeded 狀態。 如果 [移轉資料] 狀態發生問題，則移轉會進入 [已失敗] 狀態。

移轉移至 Succeeded 狀態後，即表示結構描述和資料從單一伺服器移轉至彈性伺服器的目標已完成。 您可以重新整理頁面以檢查進度。

驗證和移轉

在此選項中，移轉開始之前會先執行驗證。 PerformingPreRequisiteSteps 子狀態完成之後，工作流程會移至 Validation in Progress 的子狀態。

• 如果驗證發生錯誤，移轉會進入 Failed 狀態。
• 如果驗證完成且沒有任何錯誤，則會開始移轉，且工作流程會移至 Migrating Data 的子狀態。

一旦作業完成，您就可以看到驗證和移轉的結果。

完全移轉

針對 [移轉] 與 [驗證和移轉] 移轉選項，完成線上移轉需要使用者完成額外的步驟，也就是觸發完全移轉動作。 完成基礎資料複製之後，移轉會進入 WaitingForUserAction 狀態和 aitingForCutoverTrigger 子狀態。 在此狀態中，使用者可以選取該移轉，然後選取 [完全移轉] 按鈕，以從入口網站觸發完全移轉。

在起始完全移轉之前，請務必確保：

• 停止寫入至來源：Latency (minutes) 參數為 0 或接近 0，您可以從移轉詳細資料畫面取得 Latency (minutes) 資訊，如下所示：

Latency (minutes) 參數指出目標上次與來源同步的時間。 例如，針對上述訂單資料庫，其為 0.33333。 這表示來源過去 ~0.3 分鐘內發生的變更尚未傳送至訂單資料庫的目標。 此時，便可以停止寫入至來源並起始完全移轉。 如果來源有大量流量，建議先停止寫入，以便讓 Latency (minutes) 接近 0，然後再起始完全移轉。 完全移轉作業會將來源的所有擱置變更套用至目標，並完成移轉。 如果您觸發完全移轉，即使是非零延遲，複寫仍會停止，直到該時間點為止。 所有在完全移轉點之前的來源資料，都會套用至目標。 假設延遲在完全移轉點為 15 分鐘，因而最後 15 分鐘內的所有變更資料都會套用至目標。 花費的時間將取決於過去 15 分鐘內發生的變更待辦項目。 因此，建議您在觸發完全移轉之前，讓延遲為零或接近零。

一旦正在移轉資料子狀態或完全移轉 (在線上移轉模式中) 成功完成之後，移轉就會進入成功狀態。 如果正在移轉資料子狀態發生問題，則移轉會進入失敗狀態。

可能的移轉狀態包括：

• InProgress：正在設定移轉基礎結構，或正在移轉實際的資料。
• Canceled：已取消或刪除移轉。
• Failed：移轉已失敗。
• Validation Failed：驗證已失敗。
• Succeeded：移轉已成功且已完成。

可能的移轉子狀態包括：

• PerformingPreRequisiteSteps：正在設定基礎結構並準備移轉資料。
• Validation in Progress：驗證正在進行中。
• MigratingData：資料移轉正在進行中。
• CompletingMigration：移轉處於完成的最終階段。
• Completed：移轉已成功完成。

使用入口網站取消移轉

您可以取消任何進行中的驗證或移轉。 工作流程必須處於 InProgress 狀態，才能取消。 您無法取消處於 Succeeded 或 Failed 狀態的移轉。

取消驗證會停止任何進一步的驗證活動，而驗證會移至 Canceled 狀態。

取消移轉會停止目標伺服器上的進一步移轉活動，並移至 Canceled 狀態。 取消動作會回復移轉服務在目標伺服器上所做的所有變更。

CLI

您可使用 Azure CLI 進行移轉。

離線

必要條件 (離線)

在適用於 PostgreSQL 的 Azure 資料庫中使用移轉服務開始進行移轉之前，您必須滿足下列適用於離線移轉案例的必要條件。

驗證來源版本

來源 PostgreSQL 版本應該是 >= 9.5。 如果來源 PostgreSQL 版本小於 9.5，請先將來源 PostgreSQL 版本升級至 9.5 或更新版本，再進行移轉。

目標設定

• 開始移轉流程之前，必須先在 Azure 中部署並正確設定適用於 PostgreSQL 的 Azure 資料庫彈性伺服器。

• 為適用於 PostgreSQL 的 Azure 資料庫選擇的 SKU 應與來源資料庫的規格對應，以確保相容性和適當的效能。

• 關於如何建立新的適用於 PostgreSQL 的 Azure 資料庫，如需詳細指示，請參閱下列連結：快速入門：建立伺服器。

網路設定

網路設定對於讓移轉服務能夠正常運作至關重要。 請確定來源 PostgreSQL 伺服器可以與目標適用於 PostgreSQL 的 Azure 資料庫伺服器通訊。 下列網路設定對於成功移轉而言非常重要。

如需網路設定的相關資訊，請參閱移轉服務的網路指南。

啟用延伸模組

若要確保能在適用於 PostgreSQL 的 Azure 資料庫中使用移轉服務成功移轉，您可能需要驗證來源 PostgreSQL 執行個體的延伸模組。 延伸模組會提供應用程式可能需要的其他功能與特性。 起始移轉流程之前，請務必驗證來源 PostgreSQL 執行個體上的延伸模組。

在目標適用於 PostgreSQL 的 Azure 資料庫彈性伺服器上，啟用來源 PostgreSQL 執行個體中識別出的支援延伸模組。

如需延伸模組的詳細資訊，請參閱適用於 PostgreSQL 的 Azure 資料庫中的延伸模組。

注意

當 shared_preload_libraries 參數有任何變更時，就需要重新啟動。

檢查伺服器參數

這些參數不會自動移轉至目標環境，必須手動設定。

• 透過存取 Azure 入口網站中的 [伺服器參數] 區段，並據以手動更新參數值，讓來源 PostgreSQL 資料庫與適用於 PostgreSQL 的 Azure 資料庫有相符的伺服器參數值。

• 儲存參數變更，並視需要重新啟動適用於 PostgreSQL 的 Azure 資料庫彈性伺服器以套用新設定。

在目標中停用高可用性 (可靠性) 和讀取複本

• 請務必在目標環境中停用高可用性 (可靠性) 和讀取複本。 請在移轉完成後，才啟用這些功能。

• 透過遵循這些指導方針，您可以協助確保移轉流程順暢進行，而不會因為高可用性和讀取複本而增添變數。 移轉完成且資料庫穩定之後，便可以繼續啟用這些功能，以增強 Azure 中資料庫環境的可用性和可擴縮性。

開始使用

1. 如果您不熟悉 Microsoft Azure，請建立帳戶來評估這些供應項目。

2. 從 Azure CLI 安裝頁面安裝您作業系統的最新 Azure CLI。

   如果已安裝 Azure CLI，請使用 az version 命令來檢查版本。 版本應該是 2.50.0 或更新版本，才能使用移轉 CLI 命令。 如果不是，請更新 Azure CLI 版本。

3. 執行 az login 命令：

   az login
   

   瀏覽器視窗隨即開啟，其中包含 Azure 登入頁面。 請提供您的 Azure 認證以執行成功的驗證。 如需使用 Azure CLI 登入的其他方式，請參閱這篇文章。

移轉 CLI 命令 (離線)

移轉服務隨附於便於使用的 CLI 命令，可執行移轉相關工作。 所有 CLI 命令都會以 az postgres flexible-server migration 開頭。 請務必先將延伸模組加入允許清單，再起始移轉。

如需說明以了解與命令相關聯的選項及建立正確語法的框架，您可以使用 --help 參數：

az postgres flexible-server migration --help

執行前一個命令會傳回下列輸出：

該輸出會列出支援的移轉命令及其動作。 讓我們詳細來看這些命令。

使用 Azure CLI 建立移轉

create 命令可協助建立從來源伺服器到目標伺服器的移轉：

az postgres flexible-server migration create --help

執行前一個命令會傳回下列輸出：

列出預期的引數並具有範例語法，可成功建立從來源伺服器到目標伺服器的移轉。 以下是用於建立新移轉的 CLI 命令：

az postgres flexible-server migration create [--subscription]
                                             [--resource-group]
                                             [--name]
                                             [--migration-name]
                                             [--migration-mode]
                                             [--properties]

參數	描述
subscription	彈性伺服器目標的訂閱識別碼。
resource-group	彈性伺服器目標的資源群組。
name	彈性伺服器目標的名稱。
migration-name	每個至此彈性伺服器目標之移轉的唯一識別碼。 此欄位只接受英數字元，不接受任何特殊字元，但底線 (_) 和連字號 (-) 除外。 名稱必須以英數字元開頭和結束。 目標伺服器的名稱也必須是唯一，因為不會有兩個至相同彈性伺服器目標的移轉可以具有相同名稱。
migration-mode	這是選擇性參數。 預設值：離線。 離線移轉涉及在某個時間點將來源資料庫複製到目標伺服器。
properties	具有單一伺服器來源相關資訊之 JSON 檔案的絕對路徑。

例如：

az postgres flexible-server migration create --subscription 11111111-1111-1111-1111-111111111111 --resource-group my-learning-rg --name myflexibleserver --migration-name migration1 --properties "./migrationBody.json" --migration-mode offline

create 命令中使用的 migration-name 引數會用於其他 CLI 命令，例如 update、delete 和 show.。在所有這些命令中，它會唯一識別對應動作中的移轉嘗試。

最後，create 命令需要將 JSON 檔案作為其 properties 引數的一部分傳遞。

JSON 的結構如下：

{
  "properties": {
    "sourceDbServerResourceId": "/subscriptions/<subscriptionid>/resourceGroups/<sourceServerResourceGroup>/providers/Microsoft.DBforPostgreSQL/servers/<sourceServer>",
    "secretParameters": {
      "adminCredentials": {
        "sourceServerPassword": "<password>",
        "targetServerPassword": "<password>"
      }
    },
    "sourceServerUserName": "<username>@<servername>",
    "targetServerUserName": "<username>",
    "dbsToMigrate": ["<db1>", "<db2>"],
    "overwriteDbsInTarget": "true"
  }
}

進入 JSON 檔案格式的 create 參數如下所示：

參數	類型	描述
sourceDbServerResourceId	必要	此參數是單一伺服器來源的資源識別碼。
adminCredentials	必要	此參數會同時列出單一伺服器來源和彈性伺服器目標的管理使用者密碼。 這些密碼有助於向來源伺服器和目標伺服器進行驗證，
sourceServerUserName	必要	預設值是在建立單一伺服器期間指定的管理使用者，而提供的密碼會用於驗證此使用者。 如果您未使用預設使用者，此參數是執行移轉之來源伺服器上的使用者或角色。 此使用者應該在移轉所涉及的資料庫物件上擁有必要的權限和所有權，而且應該是 azure_pg_admin 角色的成員。
targetServerUserName	必要	預設值是在建立彈性伺服器期間建立的管理使用者，而提供的密碼會用於驗證此使用者。 如果您未使用預設使用者，此參數是用來執行移轉之目標伺服器上的使用者或角色。 此使用者應該是 azure_pg_admin、pg_read_all_settings、pg_read_all_stats、pg_stat_scan_tables 角色的成員，而且應該具有建立角色、建立資料庫屬性。
dbsToMigrate	必要	指定您要移轉到彈性伺服器的資料庫清單。 僅會移轉使用者資料庫。 系統資料庫或範本資料庫 (例如 template0 和 template1) 不會移轉。
overwriteDbsInTarget	必要	設定為 True 時，如果目標伺服器的現有資料庫剛好與您嘗試移轉的資料庫同名，則移轉服務會自動覆寫資料庫。
setupLogicalReplicationOnSourceDBIfNeeded	選擇性	您可以將此屬性設定為 true，自動在來源伺服器上啟用邏輯複寫。 伺服器設定中的這項變更需要重新啟動伺服器，停機時間為兩到三分鐘。
sourceDBServerFullyQualifiedDomainName	選擇性	當使用自訂 DNS 伺服器進行虛擬網路的名稱解析時，請使用該參數。 請根據此屬性的自訂 DNS 伺服器，提供單一伺服器來源的 FQDN。
targetDBServerFullyQualifiedDomainName	選擇性	當使用自訂 DNS 伺服器在虛擬網路內進行名稱解析時，請使用該參數。 請根據自訂 DNS 伺服器，提供彈性伺服器目標的 FQDN。 僅在使用自訂 DNS 伺服器進行名稱解析而不是 Azure 提供之 DNS 的罕見情況下，才包含 sourceDBServerFullyQualifiedDomainName 和 targetDBServerFullyQualifiedDomainName 作為 JSON 的一部分。 否則，請勿包含這些參數作為 JSON 檔案。

請注意命令回應的這些重點：

• 觸發 create 命令時，移轉就會進入 InProgress 狀態和 PerformingPreRequisiteSteps 子狀態。 移轉工作流程需要幾分鐘的時間，才能部署移轉基礎結構，並在來源和目標之間設定連線。
• 當 PerformingPreRequisiteSteps 子狀態完成之後，移轉就會進入 Migrating Data, 的子狀態，以進行資料庫複製。
• 每個要移轉的資料庫都有自己的區段，其中包含所有移轉詳細資料，例如資料表計數、累加式插入數、刪除數和擱置的位元組數。
• Migrating Data 子狀態完成所需的時間取決於要移轉的資料庫大小。
• 一旦 Migrating Data 子狀態成功完成，移轉就會進入 Succeeded 狀態。 如果 Migrating Data 子狀態發生問題，移轉就會進入 Failed 狀態。

列出移轉

list 命令會列出對彈性伺服器目標所做的所有移轉嘗試：

az postgres flexible-server migration list [--subscription]
                                           [--resource-group]
                                           [--name]
                                           [--filter]

filter 參數有兩個選項：

• Active：列出對目標伺服器的目前作用中 (進行中) 移轉嘗試。 不會包含已失敗、已取消或成功的移轉。
• All：列出對目標伺服器的所有移轉嘗試。 這包含作用中和完成的移轉，而不論狀態為何。

如需此命令的詳細資訊，請使用 --help 參數：

az postgres flexible-server migration list --help

監視移轉

--show 命令可協助您監視進行中的移轉，並提供移轉的目前狀態和子狀態。

az postgres flexible-server migration show [--subscription]
                                           [--resource-group]
                                           [--name]
                                           [--migration-name]

migration_name 參數是在 create 命令期間指派給移轉的名稱。 以下是 CLI 命令的範例回應快照集，其中顯示詳細資料：

如需此命令的詳細資訊，請使用 --help 參數：

 az postgres flexible-server migration show --help

下表描述移轉狀態和子狀態。

移轉狀態	描述
InProgress	已設定移轉基礎結構，或實際的資料移轉進行中。
Canceled	已取消或已刪除移轉。
Failed	移轉失敗。
Succeeded	移轉成功且已完成。
ValidationFailed	移轉在移轉前驗證期間失敗。

移轉子狀態	描述
PerformingPreRequisiteSteps	基礎結構已設定並準備進行資料移轉。
MigratingData	資料移轉正在進行中。
CompletingMigration	正在完成移轉流程。
Completed	移轉已完成，而不論是否處於成功狀態。
CancelingRequestedDBMigrations	正在取消移轉。
ValidationInProgress	驗證正在進行中。

線上存取

必要條件 (線上)

在使用適用於 PostgreSQL 的 Azure 資料庫中的移轉服務開始進行移轉之前，請先滿足下列適用於離線移轉案例的必要條件。

驗證來源版本

來源 PostgreSQL 版本應該是 >= 9.5。 如果來源 PostgreSQL 版本小於 9.5，請先將來源 PostgreSQL 版本升級至 9.5 或更新版本，再進行移轉。

設定線上移轉參數

針對線上移轉，應在來源 PostgreSQL 伺服器的 [複寫設定] 下將複製支援設為 [邏輯]。 此外，伺服器參數 max_wal_senders 和 max_replication_slots 值應該大於需要移轉的資料庫數目。 您可以在 Azure 入口網站中的 [設定] -> [伺服器參數] 下設定參數，或使用下列命令在命令列中進行設定：

• ALTER SYSTEM SET wal_level = 邏輯;
• ALTER SYSTEM SET max_wal_senders = number of databases to migrate + 1;
• ALTER SYSTEM SET max_replication_slots = number of databases to migrate + 1;

請確定沒有 長時間執行的交易。 長時間執行的交易不允許建立複寫位置。 如果認可或回復所有長時間執行的交易，複寫位置的建立將會成功。 完成所有線上移轉必要條件之後，您必須重新啟動來源 PostgreSQL 伺服器。

注意

針對使用適用於 PostgreSQL 的 Azure 資料庫單一伺服器進行線上移轉，Azure 複寫支援會在 Azure 入口網站中單一伺服器頁面的 [復寫設定] 底下的 [邏輯]。

若要防止連線移轉用盡可儲存記錄的儲存體，請確定您有足夠的資料表空間使用已佈建的受控磁碟。 若要達成此目的，請在移轉期間停用彈性伺服器上的伺服器參數 azure.enable_temp_tablespaces_on_local_ssd，並在移轉之後將其還原為原始狀態。

設定目標

• 移轉前必須先在 Azure 中設定適用於 PostgreSQL 的 Azure 資料庫。

• 為適用於 PostgreSQL 的 Azure 資料庫選擇的 SKU 應與來源資料庫的規格對應，以確保相容性和適當的效能。

• 關於如何建立新的適用於 PostgreSQL 的 Azure 資料庫，如需詳細指示，請參閱下列連結：快速入門：建立伺服器。

• 伺服器參數 max_replication_slots 應該大於需要移轉的資料庫數目。 可以在 Azure 入口網站中的 [設定] -> [伺服器參數] 下設定參數，或使用下列命令在命令列中進行設定：

• ALTER SYSTEM SET max_replication_slots = number of databases to migrate + 1;

設定網路

網路設定對於讓移轉服務能夠正常運作至關重要。 請確定來源 PostgreSQL 伺服器可以與目標適用於 PostgreSQL 的 Azure 資料庫伺服器通訊。 下列網路設定對於成功移轉而言非常重要。

如需網路設定的相關資訊，請參閱移轉服務的網路指南。

啟用延伸模組

若要確保能在適用於 PostgreSQL 的 Azure 資料庫中使用移轉服務成功移轉，您可能需要驗證來源 PostgreSQL 執行個體的延伸模組。 延伸模組會提供應用程式可能需要的其他功能與特性。 起始移轉流程之前，請務必驗證來源 PostgreSQL 執行個體上的延伸模組。

在目標適用於 PostgreSQL 的 Azure 資料庫彈性伺服器上，啟用來源 PostgreSQL 執行個體中識別出的支援延伸模組。

如需延伸模組的詳細資訊，請參閱適用於 PostgreSQL 的 Azure 資料庫中的延伸模組。

注意

當 shared_preload_libraries 參數有任何變更時，就需要重新啟動。

伺服器參數

這些參數不會自動移轉至目標環境，必須手動設定。

• 藉由存取 Azure 入口網站中的 [伺服器參數] 區段，並據以手動更新參數值，讓來源 PostgreSQL 資料庫與適用於 PostgreSQL 的 Azure 資料庫有相符的伺服器參數值。

• 儲存參數變更，並視需要重新啟動適用於 PostgreSQL 的 Azure 資料庫以套用新的設定。

在目標中停用高可用性 (可靠性) 和讀取複本

• 請務必要在目標環境中停用高可用性 (可靠性)和讀取複本。 請在移轉完成後，才啟用這些功能。

• 藉由遵循這些指導方針，可協助確保移轉程序順暢進行，而不會因為 HA 和讀取複本而增添變數。 移轉完成且資料庫穩定之後，便可以繼續啟用這些功能，以增強 Azure 中資料庫環境的可用性和可擴縮性。

注意

某些限制適用於連線移轉，而這些限制記載在這裡。 請確定您的資料庫符合執行連線移轉的規範。

開始使用

1. 如果您不熟悉 Microsoft Azure，請建立帳戶來評估這些供應項目。

2. 從 Azure CLI 安裝頁面安裝您作業系統的最新 Azure CLI。

   如果已安裝 Azure CLI，請使用 az version 命令來檢查版本。 版本應該是 2.50.0 或更新版本，才能使用移轉 CLI 命令。 如果不是，請更新 Azure CLI 版本。

3. 執行 az login 命令：

   az login
   

   瀏覽器視窗隨即開啟，其中包含 Azure 登入頁面。 請提供您的 Azure 認證以執行成功的驗證。 如需使用 Azure CLI 登入的其他方式，請參閱這篇文章。

移轉 CLI 命令 (線上)

移轉服務隨附於便於使用的 CLI 命令，可執行移轉相關工作。 所有 CLI 命令都會以 az postgres flexible-server migration 開頭。 請務必先將延伸模組加入允許清單，再起始移轉。

如需說明以了解與命令相關聯的選項及建立正確語法的框架，您可以使用 --help 參數：

az postgres flexible-server migration --help

執行前一個命令會傳回下列輸出：

該輸出會列出支援的移轉命令及其動作。 讓我們詳細來看這些命令。

使用 Azure CLI 建立移轉

create 命令可協助建立從來源伺服器到目標伺服器的移轉：

az postgres flexible-server migration create --help

執行前一個命令會傳回下列輸出：

列出預期的引數並具有範例語法，可成功建立從來源伺服器到目標伺服器的移轉。 以下是用於建立新移轉的 CLI 命令：

az postgres flexible-server migration create [--subscription]
                                             [--resource-group]
                                             [--name]
                                             [--migration-name]
                                             [--migration-mode]
                                             [--properties]

參數	描述
subscription	彈性伺服器目標的訂閱識別碼。
resource-group	彈性伺服器目標的資源群組。
name	彈性伺服器目標的名稱。
migration-name	每個至此彈性伺服器目標之移轉的唯一識別碼。 此欄位只接受英數字元，不接受任何特殊字元，但底線 (_) 和連字號 (-) 除外。 名稱必須以英數字元開頭和結束。 目標伺服器的名稱也必須是唯一，因為不會有兩個至相同彈性伺服器目標的移轉可以具有相同名稱。
migration-mode	這是選擇性參數。 預設值為 Offline。 針對線上移轉，您必須傳遞 Online。
properties	具有單一伺服器來源相關資訊之 JSON 檔案的絕對路徑。

例如：

az postgres flexible-server migration create --subscription 11111111-1111-1111-1111-111111111111 --resource-group my-learning-rg --name myflexibleserver --migration-name migration1 --properties "./migrationBody.json" --migration-mode online

create 命令中使用的 migration-name 引數會用於其他 CLI 命令，例如 update、delete 和 show.。在所有這些命令中，它會唯一識別對應動作中的移轉嘗試。

最後，create 命令需要將 JSON 檔案作為其 properties 引數的一部分傳遞。

JSON 的結構如下：

{
  "properties": {
    "sourceDbServerResourceId": "/subscriptions/<subscriptionid>/resourceGroups/<sourceServerResourceGroup>/providers/Microsoft.DBforPostgreSQL/servers/<sourceServer>",
    "secretParameters": {
      "adminCredentials": {
        "sourceServerPassword": "<password>",
        "targetServerPassword": "<password>"
      }
    },
    "sourceServerUserName": "<username>@<servername>",
    "targetServerUserName": "<username>",
    "dbsToMigrate": ["<db1>", "<db2>"],
    "overwriteDbsInTarget": "true"
  }
}

進入 JSON 檔案格式的 create 參數如下所示：

參數	類型	描述
sourceDbServerResourceId	必要	此參數是單一伺服器來源的資源識別碼。
adminCredentials	必要	此參數會同時列出單一伺服器來源和彈性伺服器目標的管理使用者密碼。 這些密碼有助於向來源伺服器和目標伺服器進行驗證，
sourceServerUserName	必要	預設值是在建立單一伺服器期間指定的管理使用者，而提供的密碼會用於驗證此使用者。 如果您未使用預設使用者，此參數是執行移轉之來源伺服器上的使用者或角色。 此使用者應該在移轉所涉及的資料庫物件上擁有必要的權限和所有權，而且應該是 azure_pg_admin 角色的成員。
targetServerUserName	必要	預設值是在建立彈性伺服器期間建立的管理使用者，而提供的密碼會用於驗證此使用者。 如果您未使用預設使用者，此參數是用來執行移轉之目標伺服器上的使用者或角色。 此使用者應該是 azure_pg_admin、pg_read_all_settings、pg_read_all_stats、pg_stat_scan_tables 角色的成員，而且應該具有建立角色、建立資料庫屬性。
dbsToMigrate	必要	指定您要移轉到彈性伺服器的資料庫清單。 僅會移轉使用者資料庫。 系統資料庫或範本資料庫 (例如 template0 和 template1) 不會移轉。
overwriteDbsInTarget	必要	設定為 True 時，如果目標伺服器的現有資料庫剛好與您嘗試移轉的資料庫同名，則移轉服務會自動覆寫資料庫。
setupLogicalReplicationOnSourceDBIfNeeded	選擇性	您可以將此屬性設定為 true，自動在來源伺服器上啟用邏輯複寫。 伺服器設定中的這項變更需要重新啟動伺服器，停機時間為兩到三分鐘。
sourceDBServerFullyQualifiedDomainName	選擇性	當使用自訂 DNS 伺服器進行虛擬網路的名稱解析時，請使用該參數。 請根據此屬性的自訂 DNS 伺服器，提供單一伺服器來源的 FQDN。
targetDBServerFullyQualifiedDomainName	選擇性	當使用自訂 DNS 伺服器在虛擬網路內進行名稱解析時，請使用該參數。 請根據自訂 DNS 伺服器，提供彈性伺服器目標的 FQDN。 僅在使用自訂 DNS 伺服器進行名稱解析而不是 Azure 提供之 DNS 的罕見情況下，才包含 sourceDBServerFullyQualifiedDomainName 和 targetDBServerFullyQualifiedDomainName 作為 JSON 的一部分。 否則，請勿包含這些參數作為 JSON 檔案。

請注意命令回應的這些重點：

• 觸發 create 命令時，移轉就會進入 InProgress 狀態和 PerformingPreRequisiteSteps 子狀態。 移轉工作流程需要幾分鐘的時間，才能部署移轉基礎結構，並在來源和目標之間設定連線。
• 當 PerformingPreRequisiteSteps 子狀態完成之後，移轉就會進入 Migrating Data, 的子狀態，以進行資料庫複製。
• 每個要移轉的資料庫都有自己的區段，其中包含所有移轉詳細資料，例如資料表計數、累加式插入數、刪除數和擱置的位元組數。
• Migrating Data 子狀態完成所需的時間取決於要移轉的資料庫大小。
• 一旦 Migrating Data 子狀態成功完成，移轉就會進入 Succeeded 狀態。 如果 Migrating Data 子狀態發生問題，移轉就會進入 Failed 狀態。

設定複寫

針對線上移轉模式，必須在來源單一伺服器中開啟邏輯複寫。 如果未開啟，當 setupLogicalReplicationOnSourceDBIfNeeded 參數以隨附於 JSON 檔案中的 true 值傳遞時，移轉服務會自動在來源單一伺服器上開啟邏輯複寫。 您也可以使用下列命令，在開始移轉之後，在來源手動設定複寫。 開啟邏輯複寫的任一種方法都會重新啟動來源單一伺服器。

例如：

az postgres flexible-server migration update --subscription 11111111-1111-1111-1111-111111111111 --resource-group my-learning-rg --name myflexibleserver --migration-name CLIMigrationExample --setup-replication

當彈性伺服器處於 WaitingForLogicalReplicationSetupRequestOnSourceDB 狀態等候時，需要此命令才能進行移轉。

若要執行線上移轉，請使用：

az postgres flexible-server migration create --subscription 11111111-1111-1111-1111-111111111111 --resource-group my-learning-rg --name myflexibleserver --migration-name migration1 --properties "./migrationBody.json" --migration-mode online

列出移轉

list 命令會列出對彈性伺服器目標所做的所有移轉嘗試：

az postgres flexible-server migration list [--subscription]
                                           [--resource-group]
                                           [--name]
                                           [--filter]

filter 參數有兩個選項：

• Active：列出對目標伺服器的目前作用中 (進行中) 移轉嘗試。 不會包含已失敗、已取消或成功的移轉。
• All：列出對目標伺服器的所有移轉嘗試。 這包含作用中和完成的移轉，而不論狀態為何。

如需此命令的詳細資訊，請使用 --help 參數：

az postgres flexible-server migration list --help

監視移轉

show 命令可協助您監視進行中的移轉，並提供移轉的目前狀態和子狀態。

az postgres flexible-server migration show [--subscription]
                                           [--resource-group]
                                           [--name]
                                           [--migration-name]

migration_name 參數是在 create 命令期間指派給移轉的名稱。 以下是 CLI 命令的範例回應快照集，其中顯示詳細資料：

如需此命令的詳細資訊，請使用 --help 參數：

 az postgres flexible-server migration show --help

下表描述移轉狀態和子狀態。

移轉狀態	描述
InProgress	已設定移轉基礎結構，或實際的資料移轉進行中。
Canceled	已取消或已刪除移轉。
Failed	移轉失敗。
Succeeded	移轉成功且已完成。
ValidationFailed	移轉在移轉前驗證期間失敗。

移轉子狀態	描述
PerformingPreRequisiteSteps	基礎結構已設定並準備進行資料移轉。
MigratingData	資料移轉正在進行中。
WaitingForCutoverTrigger	資料移轉工作已完成，並等候使用者觸發完全移轉。
CompletingMigration	正在完成移轉流程。
Completed	移轉已完成，而不論是否處於成功狀態。
CancelingRequestedDBMigrations	正在取消移轉。
ValidationInProgress	驗證正在進行中。

完全移轉

在線上移轉中，在基礎資料移轉完成之後，移轉工作會進入 WaitingForCutoverTrigger 子狀態。 在此狀態下，使用者可以使用下列命令透過 CLI 觸發完全移轉。 您也可以從入口網站選取移轉方格中的移轉名稱來觸發完全移轉。

例如：

az postgres flexible-server migration update --subscription 11111111-1111-1111-1111-111111111111 --resource-group my-learning-rg --name myflexibleserver --migration-name CLIMigrationExample --cutover

在起始完全移轉之前，請務必確保：

• 停止寫入至來源：latency 參數為 0 或接近 0

latency 參數指出目標上次與來源同步的時間。 例如，以下是兩個資料庫的 201 和 202，如下圖所示。 這表示來源過去 ~200 秒內發生的變更尚未同步至目標。 此時，便可以停止寫入至來源並起始完全移轉。 如果來源有大量流量，建議先停止寫入，以便讓 Latency 接近 0，然後起始完全移轉。 完全移轉作業會將來源的所有暫止的變更套用至目標，並完成移轉。 如果您觸發「完全移轉」，即使是非零 Latency，複寫仍會停止直到該時間點為止。 所有在完全移轉點之前的來源資料，都會套用至目標。 假設延遲在完全移轉點為 15 分鐘，因此最後 15 分鐘內的所有變更資料都會套用至目標上。 花費的時間將取決於過去 15 分鐘內發生的變更待辦項目。 因此，建議您在觸發完全移轉之前，將延遲移至零或接近零。 您可以使用 migration show 命令取得 latency 資訊。

以下是起始完全移轉之前移轉的快照集：

起始完全移轉之後，基礎複製期間發生的所有交易都會循序複製到目標，並完成移轉。

如果完全移轉未成功，則移轉會移至 Failed 狀態。

如需此命令的詳細資訊，請使用 --help 參數：

 az postgres flexible-server migration update --help

使用 CLI 取消移轉

您可以使用 cancel 命令來取消任何進行中的移轉嘗試。 此命令會停止特定移轉嘗試，並復原目標伺服器上的所有變更。 以下是用於取消移轉的 CLI 命令：

az postgres flexible-server migration update cancel [--subscription]
                                                    [--resource-group]
                                                    [--name]
                                                    [--migration-name]

例如：

az postgres flexible-server migration update cancel --subscription 11111111-1111-1111-1111-111111111111 --resource-group my-learning-rg --name myflexibleserver --migration-name migration1

如需此命令的詳細資訊，請使用 --help 參數：

 az postgres flexible-server migration update cancel --help

命令會提供您下列輸出：

完成之後檢查移轉

資料庫完成後，必須手動驗證來源與目標之間的資料，並確認目標資料庫中的所有物件都已成功建立。

移轉之後，便可以執行下列工作：

• 確認彈性伺服器上的資料，並確定其是與來源執行個體完全相同的複本。

• 驗證後，視需要在彈性伺服器上啟用高可用性選項。

• 變更彈性伺服器的 SKU，以符合應用程式需求。 這項變更需要重新啟動資料庫伺服器。

• 如果您有在來源執行個體中變更任何伺服器參數的預設值，請在彈性伺服器中複製這些伺服器參數值。

• 將其他伺服器設定 (例如標籤、警示和防火牆規則 (如果適用的話)) 從來源執行個體複製到彈性伺服器。

• 對應用程式進行變更，以將連接字串指向彈性伺服器。

• 密切監視資料庫效能，確認資料庫是否需要微調效能。

相關內容

• 移轉服務
• 從 AWS RDS 進行移轉
• 最佳作法
• 已知問題和限制
• 網路設定
• 預先移轉驗證