다음을 통해 공유

az postgres flexible-server migration

  • 참조

PostgreSQL 유연한 서버에 대한 마이그레이션 워크플로를 관리합니다.

명령

Name 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

하나 이상의 리소스 ID(공백으로 구분)입니다. '리소스 ID' 인수의 모든 정보를 포함하는 완전한 리소스 ID여야 합니다. --ids 또는 기타 '리소스 ID' 인수를 제공해야 합니다.

--name -n

마이그레이션 대상 서버 이름입니다.

--resource-group -g

마이그레이션 대상 서버의 리소스 그룹 이름입니다.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 위치를 구성할 수 있습니다.

전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. 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-xxxxxxxxxx/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 파일에 지정해야 합니다. 온라인(CDC 포함) 마이그레이션에 대해 --migration-mode online을 사용합니다. 마이그레이션 옵션 유효성 검사를 사용하여 요청만 유효성을 검사합니다.

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를 사용합니다.

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: 원본 서버와 대상 서버 간의 데이터 마이그레이션을 담당하는 마이그레이션 런타임 서버의 리소스 ID입니다. 샘플 migrationConfig.json 아래에 나와 있습니다. { "properties": { "sourceDBServerResourceId": "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx/resourceGroups/test-single-rg/providers/Microsoft.DBforPostgreSQL/servers/pg-single-1", "migrationRuntimeResourceId": "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/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

요청 속성입니다. 인수로 json 파일 경로를 전달하려면 큰따옴표나 따옴표를 사용하지 않습니다.

--resource-group -g

마이그레이션 대상 서버의 리소스 그룹 이름입니다.

선택적 매개 변수

--location -l

위치. 값 출처: az account list-locations. az configure --defaults location=<location>을 사용하여 기본 위치를 구성할 수 있습니다.

--migration-mode

오프라인 또는 온라인(CDC 포함) 마이그레이션.

허용되는 값: offline, online
Default value: offline
--migration-name

마이그레이션의 이름입니다.

--migration-option

지원되는 마이그레이션 옵션입니다. 기본값은 ValidateAndMigrate입니다.

허용되는 값: Migrate, Validate, ValidateAndMigrate
Default value: ValidateAndMigrate
--tags

공백으로 구분된 태그: key[=value] [key[=value] ...]. ""를 사용하여 기존 태그를 지웁니다.

전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. 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
Default value: Active
전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. 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

하나 이상의 리소스 ID(공백으로 구분)입니다. '리소스 ID' 인수의 모든 정보를 포함하는 완전한 리소스 ID여야 합니다. --ids 또는 기타 '리소스 ID' 인수를 제공해야 합니다.

--name -n

마이그레이션 대상 서버 이름입니다.

--resource-group -g

마이그레이션 대상 서버의 리소스 그룹 이름입니다.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 위치를 구성할 수 있습니다.

전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. 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

하나 이상의 리소스 ID(공백으로 구분)입니다. '리소스 ID' 인수의 모든 정보를 포함하는 완전한 리소스 ID여야 합니다. --ids 또는 기타 '리소스 ID' 인수를 제공해야 합니다.

--name -n

마이그레이션 대상 서버 이름입니다.

--resource-group -g

마이그레이션 대상 서버의 리소스 그룹 이름입니다.

--setup-replication

마이그레이션 워크플로가 원본에서 논리적 복제를 설정하도록 허용합니다. 이 명령은 원본 서버를 다시 시작합니다.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 위치를 구성할 수 있습니다.

전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 위치를 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.