az postgres flexible-server migration

管理 PostgreSQL 彈性伺服器的移轉工作流程。

命令

名稱 Description 類型 狀態
az postgres flexible-server migration check-name-availability

檢查是否可使用提供的移轉名稱。

核心 GA
az postgres flexible-server migration create

為彈性伺服器建立新的移轉工作流程。

核心 GA
az postgres flexible-server migration list

列出彈性伺服器的移轉。

核心 GA
az postgres flexible-server migration show

取得特定移轉的詳細數據。

核心 GA
az postgres flexible-server migration update

更新特定的移轉。

核心 GA

az postgres flexible-server migration check-name-availability

檢查是否可使用提供的移轉名稱。

az postgres flexible-server migration check-name-availability --migration-name
                                                              [--ids]
                                                              [--name]
                                                              [--resource-group]
                                                              [--subscription]

範例

檢查提供的移轉名稱是否可供您的移轉工作流程使用。

az postgres flexible-server migration check-name-availability --subscription xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx --resource-group testGroup --name testserver --migration-name xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

必要參數

--migration-name

移轉的名稱。

選擇性參數

--ids

一或多個資源識別碼 (以空格分隔)。 它應該是完整資源識別碼,其中包含「資源標識碼」引數的所有資訊。 您應該提供 --ids 或其他「資源識別碼」引數。

--name -n

移轉目標伺服器名稱。

--resource-group -g

移轉目標伺服器的資源組名。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az postgres flexible-server migration create

為彈性伺服器建立新的移轉工作流程。

az postgres flexible-server migration create --name
                                             --properties
                                             --resource-group
                                             [--location]
                                             [--migration-mode {offline, online}]
                                             [--migration-name]
                                             [--migration-option {Migrate, Validate, ValidateAndMigrate}]
                                             [--tags]

範例

在參數所識別的目標伺服器上啟動移轉工作流程。 移轉的組態應該在屬性檔中指定。 不同的屬性定義為:sourceDbServerResourceId:來源伺服器詳細數據。 adminCredentials:此參數會列出來源伺服器和目標 PostgreSQL 彈性伺服器之系統管理員用戶的密碼。 targetServerUserName:預設值是在建立 PostgreSQL 目標彈性伺服器期間建立的系統管理員使用者,而提供的密碼會用於驗證此使用者。 dbsToMigrate:指定您要移轉至彈性伺服器的資料庫清單。 overwriteDBsInTarget:當設定為 true (預設值),如果目標伺服器發生現有資料庫的名稱與您嘗試移轉的資料庫相同,則移轉服務會自動覆寫資料庫。 PostgreSQLSingleServer 的範例migrationConfig.json如下所示。 { “properties”: { “sourceDBServerResourceId”: “/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx/resourceGroups/test-single-rg/providers/Microsoft.DBforPostgreSQL/servers/pg-single-1”, “secretParameters”: { “adminCredentials”: { “sourceServerPassword”: “password”, “targetServerPassword”: “password” }, “sourceServerUserName”: “testuser@pg-single-1”, “targetServerUserName”: “fspguser” }, “dBsToMigrate”: [ “postgres” ], “overwriteDbsInTarget”: “true” } } }

az postgres flexible-server migration create --subscription xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx --resource-group testGroup --name testserver       --migration-name testmigration --properties "migrationConfig.json"

在參數所識別的目標伺服器上啟動移轉工作流程。 移轉的組態應該在 migrationConfig.json 檔案中指定。 使用離線移轉 --migration-mode 進行離線移轉。

az postgres flexible-server migration create --subscription xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx --resource-group testGroup --name testserver       --migration-name testmigration --properties "migrationConfig.json" --migration-mode offline

在參數所識別的目標伺服器上啟動移轉工作流程。 移轉的組態應該在 migrationConfig.json 檔案中指定。 在在線使用 --migration-mode for Online(搭配 CDC) 移轉。 使用移轉選項 [驗證] 僅驗證要求。

az postgres flexible-server migration create --subscription xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx --resource-group testGroup --name testserver       --migration-name testmigration --properties "migrationConfig.json" --migration-mode online --migration-option Validate

在參數所識別的目標伺服器上啟動移轉工作流程。 移轉的組態應該在 migrationConfig.json 檔案中指定。 使用 --migration-option Migrate for Migrate only request。

az postgres flexible-server migration create --subscription xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx --resource-group testGroup --name testserver       --migration-name testmigration --properties "migrationConfig.json" --migration-option Migrate

若要啟動 PostgreSQLSingleServer 以外的移轉,必須在屬性檔中指定 soureType 和 sslMode。 這些屬性定義為:sourceType:值可以是 - 內部部署、AWS_RDS、AzureVM、PostgreSQLSingleServer sslMode:用於移轉的 SSL 模式。 針對其他來源類型,PostgreSQLSingleServer 的 SSL 模式是 VerifyFull 和 Prefer/Require。 如下所示的範例migrationConfig.json。 { “properties”: { “sourceDBServerResourceId”: “<<hostname or IP address>>:<port><username><>@<>”, “secretParameters”: { “adminCredentials”: { “sourceServerPassword”: “password”, “targetServerPassword”: “password” }, “sourceServerUserName”: “postgres”, “targetServerUserName”: “fspguser” }, “dBsToMigrate”: [ “ticketdb”,“timedb”,“inventorydb” ], “overwriteDbsInTarget”: “true”, “sourceType”: “OnPremises”, “sslMode”: “Prefer” } }

az postgres flexible-server migration create --subscription xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx --resource-group testGroup --name testserver         --migration-name testmigration --properties "migrationConfig.json"

在屬性檔案中指定 migrationRuntimeResourceId,在目標伺服器上啟動已啟用私人端點的移轉工作流程。 此屬性定義為:migrationRuntimeResourceId:負責在來源和目標伺服器之間移轉數據之移轉運行時間伺服器的資源標識符。 如下所示的範例migrationConfig.json。 { “properties”: { “sourceDBServerResourceId”: “/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx/resourceGroups/test-single-rg/providers/Microsoft.DBforPostgreSQL/servers/pg-single-1”, “migrationRuntimeResourceId”: “/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx/resourceGroups/testGroup/providers/Microsoft.DBforPostgreSQL/flexibleServers/testsourcemigration”, “secretParameters”: { “adminCredentials”: { “sourceServerPassword”: “password”,targetServerPassword“: ”password“ }, ”sourceServerUserName“: ”testuser@pg-single-1“, ”targetServerUserName“: ”fspguser“ }, ”dBsToMigrate“: [ ”postgres“ ], ”overwriteDbsInTarget“: ”true“ } } }

az postgres flexible-server migration create --subscription xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx --resource-group testGroup --name testserver --migration-name testmigration --properties "migrationConfig.json"

必要參數

--name -n

移轉目標伺服器名稱。

--properties -b

要求屬性。 使用 double 或 no quotes 傳入 json filepath 作為自變數。

--resource-group -g

移轉目標伺服器的資源組名。

選擇性參數

--location -l

位置。​​ 值的來源:az account list-locations。 您可以使用 az configure --defaults location=<location> 設定預設位置。

--migration-mode

離線或線上(使用 CDC) 移轉。

接受的值: offline, online
預設值: offline
--migration-name

移轉的名稱。

--migration-option

支援的移轉選項。 預設值為 ValidateAndMigrate。

接受的值: Migrate, Validate, ValidateAndMigrate
預設值: ValidateAndMigrate
--tags

以空格分隔的標記:key[=value] [key[=value] ...]。使用 「清除現有的標記」。

全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az postgres flexible-server migration list

列出彈性伺服器的移轉。

az postgres flexible-server migration list --name
                                           --resource-group
                                           [--filter {Active, All}]

範例

列出目標彈性伺服器的目前作用中移轉。

az postgres flexible-server migration list --subscription xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx --resource-group testGroup --name testserver --filter Active

列出目標彈性伺服器的所有 (作用中/已完成) 移轉。

az postgres flexible-server migration list --subscription xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx --resource-group testGroup --name testserver --filter All

必要參數

--name -n

伺服器的名稱。 名稱只能包含小寫字母、數字及連字號 (-) 字元。 最少 3 個字元,最多 63 個字元。

--resource-group -g

移轉目標伺服器的資源組名。

選擇性參數

--filter

指出傳回所有移轉或只傳回作用中移轉。 有效值為:Active 和 All。

接受的值: Active, All
預設值: Active
全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az postgres flexible-server migration show

取得特定移轉的詳細數據。

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

範例

取得目標彈性伺服器特定移轉的詳細數據。

az postgres flexible-server migration show --subscription xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx --resource-group testGroup --name testserver --migration-name testmigration

必要參數

--migration-name

移轉的名稱。

選擇性參數

--ids

一或多個資源識別碼 (以空格分隔)。 它應該是完整資源識別碼,其中包含「資源標識碼」引數的所有資訊。 您應該提供 --ids 或其他「資源識別碼」引數。

--name -n

移轉目標伺服器名稱。

--resource-group -g

移轉目標伺服器的資源組名。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az postgres flexible-server migration update

更新特定的移轉。

az postgres flexible-server migration update --migration-name
                                             [--cancel]
                                             [--cutover]
                                             [--ids]
                                             [--name]
                                             [--resource-group]
                                             [--setup-replication]
                                             [--subscription]

範例

允許移轉工作流程在來源上設定邏輯複寫。 請注意,此命令將會重新啟動來源伺服器。

az postgres flexible-server migration update --subscription xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx --resource-group testGroup --name testserver --migration-name testmigration --setup-replication

針對移轉所涉及的所有資料庫,剪下數據遷移。 完成之後,移轉中所有資料庫的後續更新將不會移轉至目標。 完全移轉只能針對 migration_mode=Online 觸發。

az postgres flexible-server migration update --subscription xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx --resource-group testGroup --name testserver --migration-name testmigration --cutover

取消移轉所涉及的所有資料庫的數據遷移。 只能取消 'InProgress' 移轉

az postgres flexible-server migration update --subscription xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx --resource-group testGroup --name testserver --migration-name testmigration --cancel

必要參數

--migration-name

移轉的名稱。

選擇性參數

--cancel

取消所有資料庫的數據遷移。

--cutover

移轉中所有資料庫的數據遷移。 完成之後,所有資料庫的後續更新將不會移轉至目標。

--ids

一或多個資源識別碼 (以空格分隔)。 它應該是完整資源識別碼,其中包含「資源標識碼」引數的所有資訊。 您應該提供 --ids 或其他「資源識別碼」引數。

--name -n

移轉目標伺服器名稱。

--resource-group -g

移轉目標伺服器的資源組名。

--setup-replication

允許移轉工作流程在來源上設定邏輯複寫。 請注意,此命令將會重新啟動來源伺服器。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。