다음을 통해 공유

az datamigration sql-db

Note

이 참조는 Azure CLI(버전 2.75.0 이상)에 대한 데이터 마이그레이션 확장의 일부입니다. az datamigration sql-db 명령을 처음 실행할 때 확장이 자동으로 설치됩니다. 확장 프로그램에 대해 자세히 알아보세요.

Sql Db를 관리합니다.

명령

Name Description 형식 상태
az datamigration sql-db cancel

SQL DB로 진행 중인 데이터베이스 마이그레이션을 중지합니다.

 Extension GA
az datamigration sql-db create

지정된 SQL Db로 새 데이터베이스 마이그레이션을 만듭니다. 이 명령은 선택한 원본 데이터베이스 테이블에서 대상 데이터베이스 테이블로 데이터를 마이그레이션할 수 있습니다. 대상 데이터베이스에 기존 테이블이 없는 경우 New-AzDataMigrationSqlServerSchema 명령을 사용하여 원본 데이터베이스에서 대상 databse로 스키마 개체를 마이그레이션하세요. New-AzDataMigrationSqlServerSchema 링크가 https://learn.microsoft.com/cli/azure/datamigration?view=azure-cli-latest#az-datamigration-sql-server-schema.

 Extension GA
az datamigration sql-db delete

진행 중이거나 완료된 데이터베이스 마이그레이션을 SQL DB로 삭제합니다.

 Extension GA
az datamigration sql-db retry

데이터베이스에 대한 마이그레이션을 다시 시도합니다.

 Extension GA
az datamigration sql-db show

지정된 SQL DB에 대해 지정된 데이터베이스 마이그레이션을 검색합니다.

 Extension GA
az datamigration sql-db wait

데이터 전송 sql-db 조건이 충족될 때까지 CLI를 대기 상태로 하십시오.

 Extension GA

az datamigration sql-db cancel

SQL DB로 진행 중인 데이터베이스 마이그레이션을 중지합니다.

az datamigration sql-db cancel --migration-operation-id
                               [--ids]
                               [--no-wait]
                               [--resource-group]
                               [--sqldb-instance-name]
                               [--subscription]
                               [--target-db-name]

예제

데이터베이스에 대한 지속적인 마이그레이션을 중지합니다.

az datamigration sql-db cancel --migration-operation-id "9a90bb84-e70f-46f7-b0ae-1aef5b3b9f07" --resource-group "testrg" --sqldb-instance-name "sqldbinstance" --target-db-name "db1"

필수 매개 변수

--migration-operation-id

ID 추적 마이그레이션 작업입니다.

선택적 매개 변수

다음 매개 변수는 선택 사항이지만 컨텍스트에 따라 명령이 성공적으로 실행되려면 하나 이상의 매개 변수가 필요할 수 있습니다.

--ids

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

속성 값
매개 변수 그룹: Resource Id Arguments
--no-wait

장기 실행 작업이 완료되기를 기다리지 마세요.

속성 값
Default value: False
--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>사용하여 기본 그룹을 구성할 수 있습니다.

속성 값
매개 변수 그룹: Resource Id Arguments
--sqldb-instance-name

대상 SQL Database 서버의 이름입니다.

속성 값
매개 변수 그룹: Resource Id Arguments
--subscription

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

속성 값
매개 변수 그룹: Resource Id Arguments
--target-db-name

대상 데이터베이스의 이름입니다.

속성 값
매개 변수 그룹: Resource Id Arguments
전역 매개 변수
--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성 값
Default value: False
--help -h

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

--only-show-errors

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

속성 값
Default value: False
--output -o

출력 형식

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

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

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성 값
Default value: False

az datamigration sql-db create

지정된 SQL Db로 새 데이터베이스 마이그레이션을 만듭니다. 이 명령은 선택한 원본 데이터베이스 테이블에서 대상 데이터베이스 테이블로 데이터를 마이그레이션할 수 있습니다. 대상 데이터베이스에 기존 테이블이 없는 경우 New-AzDataMigrationSqlServerSchema 명령을 사용하여 원본 데이터베이스에서 대상 databse로 스키마 개체를 마이그레이션하세요. New-AzDataMigrationSqlServerSchema 링크가 https://learn.microsoft.com/cli/azure/datamigration?view=azure-cli-latest#az-datamigration-sql-server-schema.

az datamigration sql-db create --resource-group
                               --sqldb-instance-name
                               --target-db-name
                               [--migration-service]
                               [--no-wait]
                               [--scope]
                               [--source-database-name]
                               [--source-sql-connection]
                               [--table-list]
                               [--target-db-collation]
                               [--target-sql-connection]

예제

최대 매개 변수를 사용하여 데이터베이스 마이그레이션 리소스를 만들거나 업데이트합니다.

az datamigration sql-db create --migration-service "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.DataMigration/sqlMigrationServices/testagent" --scope "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/servers/sqldbinstance" --source-database-name "aaa" --source-sql-connection authentication="WindowsAuthentication" data-source="aaa" encrypt-connection=true password="placeholder" trust-server-certificate=true user-name="bbb" --table-list "[Schema1].[TableName1]" "[Schema2].[TableName2]" --target-sql-connection authentication="SqlAuthentication" data-source="sqldbinstance" encrypt-connection=true password="placeholder" trust-server-certificate=true user-name="bbb" --resource-group "testrg" --sqldb-instance-name "sqldbinstance" --target-db-name "db1"

최소 매개 변수를 사용하여 데이터베이스 마이그레이션 리소스를 만들거나 업데이트합니다.

az datamigration sql-db create --migration-service "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.DataMigration/sqlMigrationServices/testagent" --scope "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/servers/sqldbinstance" --source-database-name "aaa" --source-sql-connection authentication="WindowsAuthentication" data-source="aaa" encrypt-connection=true password="placeholder" trust-server-certificate=true user-name="bbb" --target-sql-connection authentication="SqlAuthentication" data-source="sqldbinstance" encrypt-connection=true password="placeholder" trust-server-certificate=true user-name="bbb" --resource-group "testrg" --sqldb-instance-name "sqldbinstance" --target-db-name "db1"

필수 매개 변수

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>사용하여 기본 그룹을 구성할 수 있습니다.

--sqldb-instance-name

대상 SQL Database 서버의 이름입니다.

--target-db-name

대상 데이터베이스의 이름입니다.

선택적 매개 변수

다음 매개 변수는 선택 사항이지만 컨텍스트에 따라 명령이 성공적으로 실행되려면 하나 이상의 매개 변수가 필요할 수 있습니다.

--migration-service

마이그레이션 서비스의 리소스 ID입니다.

--no-wait

장기 실행 작업이 완료되기를 기다리지 마세요.

속성 값
Default value: False
--scope

대상 리소스의 리소스 ID(SQL VM, SQL Managed Instance 또는 SQL DB)입니다.

--source-database-name

원본 데이터베이스의 이름입니다.

--source-sql-connection

원본 SQL Server 연결 세부 정보입니다.

사용: --source-sql-connection data-source=XX authentication=XX user-name=XX password=XX encrypt-connection=XX trust-server-certificate=XX

데이터 원본: 데이터 원본입니다. 인증: 인증 유형입니다. user-name: 원본 SQL에 연결할 사용자 이름입니다. password: 원본 SQL에 연결하는 암호입니다. encrypt-connection: 연결을 암호화할지 여부를 지정합니다. trust-server-certificate: 서버 인증서를 신뢰할지 여부입니다.

--table-list

복사할 테이블 목록입니다.

--target-db-collation

대상 데이터베이스에 사용할 데이터베이스 데이터 정렬입니다.

--target-sql-connection

대상 SQL DB 연결 세부 정보입니다.

사용법: --target-sql-connection data-source=XX authentication=XX user-name=XX password=XX encrypt-connection=XX trust-server-certificate=XX

데이터 원본: 데이터 원본입니다. 인증: 인증 유형입니다. user-name: 원본 SQL에 연결할 사용자 이름입니다. password: 원본 SQL에 연결하는 암호입니다. encrypt-connection: 연결을 암호화할지 여부를 지정합니다. trust-server-certificate: 서버 인증서를 신뢰할지 여부입니다.

전역 매개 변수
--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성 값
Default value: False
--help -h

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

--only-show-errors

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

속성 값
Default value: False
--output -o

출력 형식

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

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

--subscription

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

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성 값
Default value: False

az datamigration sql-db delete

진행 중이거나 완료된 데이터베이스 마이그레이션을 SQL DB로 삭제합니다.

az datamigration sql-db delete [--force {false, true}]
                               [--ids]
                               [--no-wait]
                               [--resource-group]
                               [--sqldb-instance-name]
                               [--subscription]
                               [--target-db-name]
                               [--yes]

예제

데이터베이스 마이그레이션 리소스를 삭제합니다.

az datamigration sql-db delete --resource-group "testrg" --sqldb-instance-name "sqldbinstance" --target-db-name "db1"

선택적 매개 변수

다음 매개 변수는 선택 사항이지만 컨텍스트에 따라 명령이 성공적으로 실행되려면 하나 이상의 매개 변수가 필요할 수 있습니다.

--force

선택적 강제 삭제 부울입니다. true로 제공된 경우 활성 상태인 경우에도 마이그레이션이 삭제됩니다.

속성 값
허용되는 값: false, true
--ids

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

속성 값
매개 변수 그룹: Resource Id Arguments
--no-wait

장기 실행 작업이 완료되기를 기다리지 마세요.

속성 값
Default value: False
--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>사용하여 기본 그룹을 구성할 수 있습니다.

속성 값
매개 변수 그룹: Resource Id Arguments
--sqldb-instance-name

대상 SQL Database 서버의 이름입니다.

속성 값
매개 변수 그룹: Resource Id Arguments
--subscription

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

속성 값
매개 변수 그룹: Resource Id Arguments
--target-db-name

대상 데이터베이스의 이름입니다.

속성 값
매개 변수 그룹: Resource Id Arguments
--yes -y

확인 메시지를 표시하지 않습니다.

속성 값
Default value: False
전역 매개 변수
--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성 값
Default value: False
--help -h

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

--only-show-errors

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

속성 값
Default value: False
--output -o

출력 형식

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

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

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성 값
Default value: False

az datamigration sql-db retry

데이터베이스에 대한 마이그레이션을 다시 시도합니다.

az datamigration sql-db retry [--ids]
                              [--migration-operation-id]
                              [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                              [--resource-group]
                              [--sql-db-instance-name]
                              [--subscription]
                              [--target-db-name]

예제

데이터베이스 마이그레이션 리소스를 다시 시도합니다.

az datamigration sql-db retry --resource-group testrg --sql-db-instance-name sqldbinstance --target-db-name db1 --migration-operation-id 9a90bb84-e70f-46f7-b0ae-1aef5b3b9f07

선택적 매개 변수

다음 매개 변수는 선택 사항이지만 컨텍스트에 따라 명령이 성공적으로 실행되려면 하나 이상의 매개 변수가 필요할 수 있습니다.

--ids

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

속성 값
매개 변수 그룹: Resource Id Arguments
--migration-operation-id

마이그레이션 작업을 추적하기 위한 고유 ID입니다.

속성 값
매개 변수 그룹: MigrationOperationInput Arguments
--no-wait

장기 실행 작업이 완료되기를 기다리지 마세요.

속성 값
허용되는 값: 0, 1, f, false, n, no, t, true, y, yes
--resource-group -g

Azure 리소스 그룹의 이름입니다.

속성 값
매개 변수 그룹: Resource Id Arguments
--sql-db-instance-name

SQL 데이터베이스 인스턴스의 이름입니다.

속성 값
매개 변수 그룹: Resource Id Arguments
--subscription

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

속성 값
매개 변수 그룹: Resource Id Arguments
--target-db-name

대상 데이터베이스의 이름입니다.

속성 값
매개 변수 그룹: Resource Id Arguments
전역 매개 변수
--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성 값
Default value: False
--help -h

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

--only-show-errors

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

속성 값
Default value: False
--output -o

출력 형식

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

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

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성 값
Default value: False

az datamigration sql-db show

지정된 SQL DB에 대해 지정된 데이터베이스 마이그레이션을 검색합니다.

az datamigration sql-db show [--expand]
                             [--ids]
                             [--migration-operation-id]
                             [--resource-group]
                             [--sqldb-instance-name]
                             [--subscription]
                             [--target-db-name]

예제

expand 매개 변수를 사용하여 Sql DB 데이터베이스 마이그레이션을 가져옵니다.

az datamigration sql-db show --expand "MigrationStatusDetails" --resource-group "testrg" --sqldb-instance-name "sqldbinstance" --target-db-name "db1"

expand 매개 변수 없이 Sql DB 데이터베이스 마이그레이션을 가져옵니다.

az datamigration sql-db show --resource-group "testrg" --sqldb-instance-name "sqldbinstance" --target-db-name "db1"

선택적 매개 변수

다음 매개 변수는 선택 사항이지만 컨텍스트에 따라 명령이 성공적으로 실행되려면 하나 이상의 매개 변수가 필요할 수 있습니다.

--expand

전체 마이그레이션 세부 정보는 응답에 포함됩니다.

--ids

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

속성 값
매개 변수 그룹: Resource Id Arguments
--migration-operation-id

선택적 마이그레이션 작업 ID입니다. 이 항목이 제공되면 해당 ID에 대한 마이그레이션 작업의 세부 정보가 검색됩니다. 제공되지 않은 경우(기본값) 가장 최근 또는 현재 작업과 관련된 세부 정보가 검색됩니다.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>사용하여 기본 그룹을 구성할 수 있습니다.

속성 값
매개 변수 그룹: Resource Id Arguments
--sqldb-instance-name

대상 SQL Database 서버의 이름입니다.

속성 값
매개 변수 그룹: Resource Id Arguments
--subscription

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

속성 값
매개 변수 그룹: Resource Id Arguments
--target-db-name

대상 데이터베이스의 이름입니다.

속성 값
매개 변수 그룹: Resource Id Arguments
전역 매개 변수
--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성 값
Default value: False
--help -h

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

--only-show-errors

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

속성 값
Default value: False
--output -o

출력 형식

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

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

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성 값
Default value: False

az datamigration sql-db wait

데이터 전송 sql-db 조건이 충족될 때까지 CLI를 대기 상태로 하십시오.

az datamigration sql-db wait [--created]
                             [--custom]
                             [--deleted]
                             [--exists]
                             [--expand]
                             [--ids]
                             [--interval]
                             [--migration-operation-id]
                             [--resource-group]
                             [--sqldb-instance-name]
                             [--subscription]
                             [--target-db-name]
                             [--timeout]
                             [--updated]

예제

datamigration sql-db가 성공적으로 생성될 때까지 CLI 스크립트의 다음 줄 실행을 일시 중지합니다.

az datamigration sql-db wait --resource-group "testrg" --sqldb-instance-name "sqldbinstance" --target-db-name "db1" --created

데이터 마이그레이션 sql-db가 성공적으로 삭제될 때까지 CLI 스크립트의 다음 줄 실행을 일시 중지합니다.

az datamigration sql-db wait --resource-group "testrg" --sqldb-instance-name "sqldbinstance" --target-db-name "db1" --deleted

선택적 매개 변수

다음 매개 변수는 선택 사항이지만 컨텍스트에 따라 명령이 성공적으로 실행되려면 하나 이상의 매개 변수가 필요할 수 있습니다.

--created

'Succeeded'에서 'provisioningState'를 사용하여 생성될 때까지 기다립니다.

속성 값
매개 변수 그룹: Wait Condition Arguments
Default value: False
--custom

조건이 사용자 지정 JMESPath 쿼리를 충족할 때까지 기다립니다. 예: provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

속성 값
매개 변수 그룹: Wait Condition Arguments
--deleted

삭제될 때까지 기다립니다.

속성 값
매개 변수 그룹: Wait Condition Arguments
Default value: False
--exists

리소스가 존재할 때까지 기다립니다.

속성 값
매개 변수 그룹: Wait Condition Arguments
Default value: False
--expand

전체 마이그레이션 세부 정보는 응답에 포함됩니다.

--ids

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

속성 값
매개 변수 그룹: Resource Id Arguments
--interval

폴링 간격(초)입니다.

속성 값
매개 변수 그룹: Wait Condition Arguments
Default value: 30
--migration-operation-id

선택적 마이그레이션 작업 ID입니다. 이 항목이 제공되면 해당 ID에 대한 마이그레이션 작업의 세부 정보가 검색됩니다. 제공되지 않은 경우(기본값) 가장 최근 또는 현재 작업과 관련된 세부 정보가 검색됩니다.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>사용하여 기본 그룹을 구성할 수 있습니다.

속성 값
매개 변수 그룹: Resource Id Arguments
--sqldb-instance-name

대상 SQL Database 서버의 이름입니다.

속성 값
매개 변수 그룹: Resource Id Arguments
--subscription

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

속성 값
매개 변수 그룹: Resource Id Arguments
--target-db-name

대상 데이터베이스의 이름입니다.

속성 값
매개 변수 그룹: Resource Id Arguments
--timeout

최대 대기 시간(초)입니다.

속성 값
매개 변수 그룹: Wait Condition Arguments
Default value: 3600
--updated

'Succeeded'에서 provisioningState로 업데이트될 때까지 기다립니다.

속성 값
매개 변수 그룹: Wait Condition Arguments
Default value: False
전역 매개 변수
--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성 값
Default value: False
--help -h

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

--only-show-errors

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

속성 값
Default value: False
--output -o

출력 형식

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

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

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성 값
Default value: False