az dms project task

참고 항목

이 명령 그룹에는 Azure CLI 및 하나 이상의 확장 모두에 정의된 명령이 있습니다. 확장된 기능을 활용하려면 각 확장을 설치합니다. 확장 프로그램에 대해 자세히 알아보세요.

Azure Database Migration Service(클래식) 인스턴스 프로젝트에 대한 작업을 관리합니다.

명령

Name	Description	형식	상태
az dms project task cancel	현재 큐에 대기 중이거나 실행 중인 경우 작업을 취소합니다.	핵심	GA
az dms project task cancel (dms-preview 확장)	이 명령은 더 이상 사용되지 않습니다. 대신 중지 명령을 사용합니다.	내선 번호	GA
az dms project task check-name	지정된 작업 이름이 지정된 DMS 인스턴스 내에서 사용할 수 있는지와 이름의 유효성을 확인합니다.	핵심	GA
az dms project task create	마이그레이션 작업을 만들고 시작합니다.	핵심	GA
az dms project task create (dms-preview 확장)	마이그레이션 작업을 만들고 시작합니다.	내선 번호	GA
az dms project task cutover	온라인 마이그레이션 작업의 경우 단독형을 수행하여 마이그레이션을 완료합니다.	핵심	GA
az dms project task delete	마이그레이션 작업을 삭제합니다.	핵심	GA
az dms project task list	프로젝트 내의 작업을 나열합니다. 일부 작업에는 알 수 없는 상태가 있을 수 있습니다. 이는 해당 작업의 상태를 쿼리하는 동안 오류가 발생했음을 나타냅니다.	핵심	GA
az dms project task restart	전체 마이그레이션 또는 지정된 개체만 다시 시작합니다. 현재 MongoDB 마이그레이션에서만 지원됩니다.	내선 번호	GA
az dms project task show	마이그레이션 작업의 세부 정보를 표시합니다. 자세한 내용을 보려면 "--expand"을 사용합니다.	핵심	GA
az dms project task stop	작업을 중지하거나 지정된 개체에서 마이그레이션을 중지합니다(MongoDB 마이그레이션만 해당).	내선 번호	GA

az dms project task cancel

현재 큐에 대기 중이거나 실행 중인 경우 작업을 취소합니다.

az dms project task cancel --name
                           --project-name
                           --resource-group
                           --service-name

필수 매개 변수

--name -n

작업 이름입니다.

--project-name

프로젝트의 이름입니다.

--resource-group -g

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

--service-name

서비스의 이름입니다.

전역 매개 변수

--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 dms project task cancel (dms-preview 확장)

이 명령은 더 이상 사용되지 않습니다. 대신 중지 명령을 사용합니다.

Azure의 포털 UI를 사용하여 보다 일관된 환경을 유지하려면 az dms project task stop을 사용합니다.

az dms project task cancel --name
                           --project-name
                           --resource-group
                           --service-name
                           [--object-name]

필수 매개 변수

--name -n

작업 이름입니다. DMS 프로젝트 작업은 마이그레이션 관련 작업을 수행하는 작업입니다. 프로젝트와 연결된 여러 작업이 있을 수 있습니다.

--project-name

프로젝트의 이름입니다. DMS 프로젝트는 원본 데이터베이스 연결, 대상 데이터베이스 연결 및 마이그레이션할 데이터베이스 목록을 포함하는 논리적 그룹화입니다.

--resource-group -g

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

--service-name

서비스의 이름입니다. DMS 서비스는 데이터베이스 마이그레이션을 수행하는 Azure 인스턴스입니다.

선택적 매개 변수

--object-name

MongoDB 마이그레이션에서만 지원됩니다. 중지하려는 데이터베이스 또는 컬렉션의 정규화된 이름입니다. 전체 마이그레이션을 중지하려면 비워 둡니다.

전역 매개 변수

--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 dms project task check-name

지정된 작업 이름이 지정된 DMS 인스턴스 내에서 사용할 수 있는지와 이름의 유효성을 확인합니다.

az dms project task check-name --name
                               --project-name
                               --resource-group
                               --service-name

필수 매개 변수

--name -n

확인할 작업 이름입니다.

--project-name

프로젝트의 이름입니다.

--resource-group -g

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

--service-name

서비스의 이름입니다.

전역 매개 변수

--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 dms project task create

마이그레이션 작업을 만들고 시작합니다.

지원되는 작업 구성은 -) 원본 -> 대상:: 작업 유형입니다.

1. SQL -> SQLDB :: OfflineMigration
2. PostgreSQL -> AzureDbForPostgreSql :: OnlineMigration
3. MySQL -> AzureDbForMySQL:: OfflineMigration, OnlineMigration, ReplicateChanges.

az dms project task create --database-options-json
                           --name
                           --project-name
                           --resource-group
                           --service-name
                           --source-connection-json
                           --target-connection-json
                           [--enable-data-integrity-validation]
                           [--enable-query-analysis-validation]
                           [--enable-schema-validation]
                           [--task-type]

예제

오프라인 SQL 마이그레이션 작업을 만들고 시작합니다. SQL 마이그레이션의 경우 유효성 검사를 수행하지 않습니다.

az dms project task create --task-type OfflineMigration --database-options-json "C:\CLI Files\databaseOptions.json" -n mytask --project-name myproject -g myresourcegroup --service-name mydms --source-connection-json "{'dataSource': 'myserver', 'authentication': 'SqlAuthentication', 'encryptConnection': 'true', 'trustServerCertificate': 'true'}" --target-connection-json "C:\CLI Files\targetConnection.json"

모든 유효성 검사를 수행하는 SQL 작업을 만들고 시작합니다.

az dms project task create --task-type OfflineMigration --database-options-json "C:\CLI Files\databaseOptions.json" -n mytask --project-name myproject -g myresourcegroup --service-name mydms --source-connection-json "C:\CLI Files\sourceConnection.json" --target-connection-json "C:\CLI Files\targetConnection.json" --enable-data-integrity-validation --enable-query-analysis-validation --enable-schema-validation

필수 매개 변수

--database-options-json

데이터베이스 및 테이블 정보입니다. JSON 형식 문자열이거나 JSON 개체를 포함하는 파일의 위치일 수 있습니다. 형식은 아래 예제를 참조하세요.

SQL의 경우 테이블별 마이그레이션을 지원합니다. 이를 사용하려면 아래와 같이 'table_map'에 테이블 이름을 지정합니다. 원본을 읽기 전용으로 설정할 수도 있습니다. [ { "name": "source database", "target_database_name": "target database", "make_source_db_read_only": false|true, "table_map": { "schema. SourceTableName1": "스키마. TargetTableName1", "schema. SourceTableName2": "스키마. TargetTableName2", ... n } }, ... n ]

PostgreSQL의 경우 데이터베이스 옵션 JSON 개체의 형식입니다. [ { "name": "source database", "target_database_name": "target database", // 기본 마이그레이션 엔진을 조작하는 데 사용됩니다. 그렇게 하도록 지시받은 경우 또는 실제로 무엇을 하고 있는지 알고 있는 경우에만 제공합니다. "migrationSetting": { "setting1": "value1", ... n }, // 기본 마이그레이션 엔진을 조작하는 데 사용됩니다. 그렇게 하도록 지시받은 경우 또는 실제로 무엇을 하고 있는지 알고 있는 경우에만 제공합니다. "sourceSetting": { "setting1": "value1", ... n }, // 기본 마이그레이션 엔진을 조작하는 데 사용됩니다. 그렇게 하도록 지시받은 경우 또는 실제로 무엇을 하고 있는지 알고 있는 경우에만 제공합니다. "targetSetting": { "setting1": "value1", ... 마이그레이션에 포함하려는 테이블을 나열하는 n }, // 선택적 매개 변수입니다. "selectedTables": [ "schemaName1.tableName1", ... n ] }, ... n ]

MySQL의 경우 데이터베이스 옵션 JSON 개체의 형식입니다. { // 마이그레이션해야 하는 매핑된 스키마의 세부 정보입니다. 여러 스키마를 한 번에 마이그레이션할 수 있습니다. "selected_databases":[ // database/schema 1 details { "name": "sourceSchema1", "target_database_name": "targetSchema1", // 원본에서 대상 스키마로 테이블 매핑 [선택 사항] // 이 데이터베이스의 모든 테이블을 "table_map": { "sourceSchema1.table1": "targetSchema1.table1", "sourceSchema1.table2": "targetSchema1.table2", "sourceSchema1.table3": "targetSchema1.table3", .. n } // 아래 항목은 선택적 스키마 마이그레이션 // 선택적 경우에만 필요하며 , 'tables_to_migrate_schema' 테이블에 대한 스키마를 마이그레이션합니다. { "sourceSchema1.table2": "targetSchema1.table2", "sourceSchema1.table3": "targetSchema1.table3" }, // optional, 열거형 뷰 'selected_views'을 마이그레이션합니다. [ 'sourceSchema1.view1' ], // optional, 열거형 트리거 'selected_triggers'을 마이그레이션합니다. [ 'sourceSchema1.on_table1_updated' ], //optional, 열거형 루틴 마이그레이션 'selected_routines': [ 'sourceSchema1.build_report' ], // 선택 사항으로 열거된 이벤트 'selected_events'을 마이그레이션합니다. [ 'sourceSchema1.nightly_maintenance' ], // Optional. true이면 DMS는 원본 데이터베이스 스키마를 대상으로 마이그레이션합니다. "select_database_for_schema_migration": "true|false" }, ... n ],

// Used for manipulating the underlying migration engine. [Optional]
// Only provide if instructed to do so or if you really know what you are doing.
"migration_level_settings": {
    // Optional setting that configures the maximum number of parallel reads on tables located on the source database.
    "DesiredRangesCount": "4",
    // Optional setting that configures that size of the largest batch that will be committed to the target server.
    "MaxBatchSizeKb": "4096",
    // Optional setting that configures the minimum number of rows in each batch written to the target.
    "MinBatchRows": null,
    // Optional setting that configures the number of databases that will be prepared for migration in parallel.
    "PrepareDatabaseForBulkImportTaskCount": null,
    // Optional setting that configures the number of tables that will be prepared for migration in parallel.
    "PrepareTableForBulkImportTaskCount": null,
    // Optional setting that configures the number of threads available to read ranges on the source.
    "QueryTableDataRangeTaskCount": "8",
    // Optional setting that configures the number of threads available to write batches to the target.
    "WriteDataRangeBatchTaskCount": "12",
    // Optional setting that configures how much memory will be used to cache batches in memory before reads on the source are throttled.
    "MaxBatchCacheSizeMb": null,
    // Optional setting that configures the amount of available memory at which point reads on the source will be throttled.
    "ThrottleQueryTableDataRangeTaskAtAvailableMemoryMb": null,
    // Optional setting that configures the number of batches cached in memory that will trigger read throttling on the source.
    "ThrottleQueryTableDataRangeTaskAtBatchCount": 36,
    // Optional setting that configures the delay between updates of result objects in Azure Table Storage.
    "DelayProgressUpdatesInStorageInterval": "00:00:30",
},
// Optional setting to set the source server read only.
"make_source_server_read_only": "true|false",
// Optional setting to enable consistent backup. True by default for the sync migration, and false otherwise.
"enable_consistent_backup": "true|false",
// Optional. If true, all view definitions will be migrated in the selected databases.
"migrate_all_views": "true|false",
// Optional. If true, all trigger definitions will be migrated in the selected databases.
"migrate_all_triggers": "true|false",
// Optional. If true, all event definitions will be migrated in the selected databases.
"migrate_all_events": "true|false",
// Optional. If true, all stored proc definitions will be migrated in the selected databases.
"migrate_all_routines": "true|false",
// Optional. If true, all table's schemas will be migrated.
"migrate_all_tables_schema": "true|false",
// Optional. If true, all users/grants will be migrated.
"migrate_user_system_tables": "true|false",
// Binlog position to start the migration from. Only applicable for the ReplicateChanges migration.
"binLogInfo": {
    "filename": "binlog.0004523",
    "position": 283287
}

}.

--name -n

작업 이름입니다.

--project-name

프로젝트의 이름입니다.

--resource-group -g

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

--service-name

서비스의 이름입니다.

--source-connection-json

원본 서버에 대한 연결 정보입니다. JSON 형식 문자열이거나 JSON 개체를 포함하는 파일의 위치일 수 있습니다. 형식은 아래 예제를 참조하세요.

SQL 연결에 대한 연결 JSON 개체의 형식입니다. { "userName": "user name", // 이 이름이 없거나 null이면 "password"라는 메시지가 표시됩니다. null, // 이 값이 누락되었거나 null(권장)이면 "dataSource": "server name[,port]", "authentication": "SqlAuthentication|WindowsAuthentication", "encryptConnection": true, // true "trustServerCertificate"로 두는 것이 좋습니다. false // false로 두는 것이 좋습니다. false }

PostgreSQL 연결에 대한 연결 JSON 개체의 형식입니다. { "userName": "user name", // 이 값이 없거나 null이면 "password"라는 메시지가 표시됩니다. null, // 이 값이 누락되었거나 null(매우 권장)이면 "serverName": "servername", "databaseName": "database name", // 이 항목이 없으면 기본적으로 'postgres' 데이터베이스 "port": 5432, // 이 항목이 없으면 기본값은 5432 "encryptConnection"입니다. true, // true "trustServerCertificate"로 두는 것이 좋습니다. false // false로 두는 것이 좋습니다. }

MySQL 연결에 대한 연결 JSON 개체의 형식입니다. { "userName": "user name", // if this가 없거나 null이면 "password"라는 메시지가 표시됩니다. null, // 이 값이 누락되었거나 null(매우 권장)이면 "serverName": "server name", "port": 3306 //이 누락된 경우 기본값은 3306 }입니다.

--target-connection-json

대상 서버에 대한 연결 정보입니다. JSON 형식 문자열이거나 JSON 개체를 포함하는 파일의 위치일 수 있습니다. 연결 형식의 예는 'source-connection-json'을 참조하세요.

선택적 매개 변수

--enable-data-integrity-validation

SQL에만 해당합니다. 선택한 데이터베이스와 테이블에 대한 원본과 대상 간에 체크섬 기반 데이터 무결성 유효성 검사를 수행할지 여부입니다.

Default value: False

--enable-query-analysis-validation

SQL에만 해당합니다. 원본 데이터베이스에서 쿼리를 검색하고 대상에서 실행하여 빠르고 지능적인 쿼리 분석을 수행할지 여부입니다. 결과에는 추출된 쿼리에 대한 원본 및 대상 데이터베이스의 실행에 대한 실행 통계가 포함됩니다.

Default value: False

--enable-schema-validation

SQL에만 해당합니다. 원본과 대상 간에 스키마 정보를 비교할지 여부입니다.

Default value: False

--task-type

태스크에서 지원할 데이터 이동의 형식입니다. 지원되는 유형은 OnlineMigration, OfflineMigration입니다. 제공되지 않으면 기본적으로 SQL, MySQL 및 PostgreSQL용 OnlineMigration에 대한 OfflineMigration으로 설정됩니다.

전역 매개 변수

--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 dms project task create (dms-preview 확장)

마이그레이션 작업을 만들고 시작합니다.

지원되는 작업 구성은 -) 원본 -> 대상 :: 작업 유형 1) SQL -> SQLDB :: OfflineMigration 2) PostgreSQL -> AzureDbForPostgreSQL :: OnlineMigration 3) MongoDB -> MongoDB(MongoDB API를 통해 Cosmos DB로 마이그레이션용) :: OfflineMigration입니다.

az dms project task create --database-options-json
                           --name
                           --project-name
                           --resource-group
                           --service-name
                           --source-connection-json
                           --target-connection-json
                           [--enable-data-integrity-validation]
                           [--enable-query-analysis-validation]
                           [--enable-schema-validation]
                           [--task-type]
                           [--validate-only]
                           [--validated-task-name]

예제

유효성 검사를 수행하지 않는 SQL 작업을 만들고 시작합니다.

az dms project task create --database-options-json C:\CliFiles\databaseOptions.json -n mytask --project-name myproject -g myresourcegroup --service-name mydms --source-connection-json '{'dataSource': 'myserver', 'authentication': 'SqlAuthentication', 'encryptConnection': 'true', 'trustServerCertificate': 'true'}' --target-connection-json C:\CliFiles\targetConnection.json --task-type offlinemigration

모든 유효성 검사를 수행하는 SQL 작업을 만들고 시작합니다.

az dms project task create --database-options-json C:\CliFiles\databaseOptions.json -n mytask --project-name myproject -g myresourcegroup --service-name mydms --source-connection-json C:\CliFiles\sourceConnection.json --target-connection-json C:\CliFiles\targetConnection.json --enable-data-integrity-validation --enable-query-analysis-validation --enable-schema-validation --task-type offlinemigration

필수 매개 변수

--database-options-json

데이터베이스 및 테이블 정보입니다. JSON 형식 문자열이거나 JSON 개체를 포함하는 파일의 위치일 수 있습니다. 형식은 아래 예제를 참조하세요.

SQL의 경우 테이블별 마이그레이션을 지원합니다. 이를 사용하려면 아래와 같이 'table_map'에 테이블 이름을 지정합니다. 원본을 읽기 전용으로 설정할 수도 있습니다. [ { "name": "source database", "target_database_name": "target database", "make_source_db_read_only": false|true, "table_map": { "schema. SourceTableName1": "스키마. TargetTableName1", "schema. SourceTableName2": "스키마. TargetTableName2", ... n } }, ... n ]

PostgreSQL의 경우 데이터베이스 옵션 JSON 개체의 형식입니다. [ { "name": "source database", "target_database_name": "target database", // 기본 마이그레이션 엔진을 조작하는 데 사용됩니다. 그렇게 하도록 지시받은 경우 또는 실제로 무엇을 하고 있는지 알고 있는 경우에만 제공합니다. "migrationSetting": { "setting1": "value1", ... n }, // 기본 마이그레이션 엔진을 조작하는 데 사용됩니다. 그렇게 하도록 지시받은 경우 또는 실제로 무엇을 하고 있는지 알고 있는 경우에만 제공합니다. "sourceSetting": { "setting1": "value1", ... n }, // 기본 마이그레이션 엔진을 조작하는 데 사용됩니다. 그렇게 하도록 지시받은 경우 또는 실제로 무엇을 하고 있는지 알고 있는 경우에만 제공합니다. "targetSetting": { "setting1": "value1", ... 마이그레이션에 포함하려는 테이블을 나열하는 n }, // 선택적 매개 변수입니다. "selectedTables": [ "schemaName1.tableName1", ... n ] }, ... n ]

MongoDB의 경우 컬렉션 마이그레이션을 지원합니다. 이를 사용하려면 아래와 같이 데이터베이스 개체 내의 컬렉션을 지정합니다. { // 마이그레이션 중에 기본 부스트를 얻으려면 0으로 설정(권장) "boostRUs": 0, // "OneTime" 또는 "Continuous", "OneTime"만 현재 지원됩니다. "OneTime", // 사용 가능한 최대 리소스를 사용하려면 null로 설정합니다. "제한": "minFreeCpu"를 사용하지 않도록 시도하는 CPU의 { // 백분율: "minFreeMemoryMb"를 사용하지 않도록 시도하는 RAM의 25, // 양(MB) : 1024, // 한 번에 마이그레이션할 컬렉션의 최대 수 "maxParallelism": 2 }, "databases": { "database_name": { // see https://docs.microsoft.com/th-th/azure/cosmos-db/request-units, || // 기본값을 사용하도록 null로 설정 // 또는 처리량을 데이터베이스 수준 "targetRUs"에서 프로비전하지 않아야 하는 경우 0으로 설정합니다. 0, "collections": { "collection_name_1": { // 대상 데이터베이스/컬렉션이 "canDelete"인 경우 삭제되는지 여부: true, 대상을 분할하지 않아야 하는 경우 // 또는 원본에서 분할된 데이터베이스 키를 복사(있는 경우) "shardKey": null, ///를 null로 설정하여 기본값(권장) "targetRUs": null }, "collection_name_2": { "canDelete": true, "shardKey": { "fields": [ { "name": "field_name", 는 "Forward", "Reverse" 또는 "Hashed"를 허용하지만 CosmosDB는 "Forward" }, ... n ], // 분할된 데이터베이스 키가 고유한지 여부 // https://docs.microsoft.com/azure/cosmos-db/partition-data "isUnique": false }, "targetRUs": 10000 }, ... n } }, ... n } }.

--name -n

작업 이름입니다. DMS 프로젝트 작업은 마이그레이션 관련 작업을 수행하는 작업입니다. 프로젝트와 연결된 여러 작업이 있을 수 있습니다.

--project-name

프로젝트의 이름입니다. DMS 프로젝트는 원본 데이터베이스 연결, 대상 데이터베이스 연결 및 마이그레이션할 데이터베이스 목록을 포함하는 논리적 그룹화입니다.

--resource-group -g

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

--service-name

서비스의 이름입니다. DMS 서비스는 데이터베이스 마이그레이션을 수행하는 Azure 인스턴스입니다.

--source-connection-json

원본 서버에 대한 연결 정보입니다. JSON 형식 문자열이거나 JSON 개체를 포함하는 파일의 위치일 수 있습니다. 형식은 아래 예제를 참조하세요.

SQL 연결에 대한 연결 JSON 개체의 형식입니다. { "userName": "user name", // 이 이름이 없거나 null이면 "password"라는 메시지가 표시됩니다. null, // 이 값이 누락되었거나 null(권장)이면 "dataSource": "server name[,port]", "authentication": "SqlAuthentication|WindowsAuthentication", "encryptConnection": true, // true "trustServerCertificate"로 두는 것이 좋습니다. false // false로 두는 것이 좋습니다. false }

PostgreSQL 연결에 대한 연결 JSON 개체의 형식입니다. { "userName": "user name", // 이 값이 없거나 null이면 "password"라는 메시지가 표시됩니다. null, // 이 값이 누락되었거나 null(매우 권장)이면 "serverName": "servername", "databaseName": "database name", // 이 항목이 없으면 기본적으로 'postgres' 데이터베이스 "port": 5432, // 이 항목이 없으면 기본값은 5432 "encryptConnection"입니다. true, // true "trustServerCertificate"로 두는 것이 좋습니다. false // false로 두는 것이 좋습니다. }

MongoDB 연결에 대한 연결 JSON 개체의 형식입니다. { "userName": null, // 이 값이 없거나 null이면 "password"라는 메시지가 표시됩니다. null, // 누락되었거나 null(권장)이면 "connectionString": "mongodb://hostOrIp:port" }라는 메시지가 표시됩니다.

--target-connection-json

대상 서버에 대한 연결 정보입니다. JSON 형식 문자열이거나 JSON 개체를 포함하는 파일의 위치일 수 있습니다. 연결 형식의 예는 'source-connection-json'을 참조하세요.

선택적 매개 변수

--enable-data-integrity-validation

SQL에만 해당합니다. 선택한 데이터베이스와 테이블에 대한 원본과 대상 간에 체크섬 기반 데이터 무결성 유효성 검사를 수행할지 여부입니다.

Default value: False

--enable-query-analysis-validation

SQL에만 해당합니다. 원본 데이터베이스에서 쿼리를 검색하고 대상에서 실행하여 빠르고 지능적인 쿼리 분석을 수행할지 여부입니다. 결과에는 추출된 쿼리에 대한 원본 및 대상 데이터베이스의 실행에 대한 실행 통계가 포함됩니다.

Default value: False

--enable-schema-validation

SQL에만 해당합니다. 원본과 대상 간에 스키마 정보를 비교할지 여부입니다.

Default value: False

--task-type

태스크에서 지원할 데이터 이동의 형식입니다. 지원되는 유형은 OnlineMigration, OfflineMigration입니다. 제공되지 않으면 기본적으로 SQL, MongoDB 및 PostgreSQL용 OnlineMigration에 대한 OfflineMigration으로 설정됩니다.

--validate-only

MongoDB에서 Cosmos DB로만 해당합니다. 유효성 검사만 실행할지 여부와 마이그레이션을 실행하지 않을지 여부입니다. 실제 마이그레이션을 시도하기 전에 '유효성 검사 전용' 작업을 실행해야 합니다. 유효성 검사가 완료되면 이 '유효성 검사 전용' 작업의 이름을 새 작업의 '유효성 검사된 작업 이름' 인수에 전달합니다.

Default value: False

--validated-task-name

(MongoDB에서 Cosmos DB로만 해당) 마이그레이션을 실행하는 경우 이전에 실행한 '유효성 검사 전용' 작업의 이름을 전달해야 합니다.

전역 매개 변수

--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 dms project task cutover

온라인 마이그레이션 작업의 경우 단독형을 수행하여 마이그레이션을 완료합니다.

요청 결과를 보려면 'task show' 명령을 사용하세요. az dms project task show ... --expand 명령.

az dms project task cutover --name
                            --object-name
                            --project-name
                            --resource-group
                            --service-name

필수 매개 변수

--name -n

작업 이름입니다.

--object-name

중단하려는 원본에 있는 데이터베이스의 이름입니다.

--project-name

프로젝트의 이름입니다.

--resource-group -g

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

--service-name

서비스의 이름입니다.

전역 매개 변수

--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 dms project task delete

마이그레이션 작업을 삭제합니다.

az dms project task delete --name
                           --project-name
                           --resource-group
                           --service-name
                           [--delete-running-tasks]
                           [--yes]

예제

마이그레이션 작업을 삭제합니다. (자동 생성됨)

az dms project task delete --name MyTask --project-name MyProject --resource-group MyResourceGroup --service-name MyService

필수 매개 변수

--name -n

작업 이름입니다.

--project-name

프로젝트의 이름입니다.

--resource-group -g

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

--service-name

서비스의 이름입니다.

선택적 매개 변수

--delete-running-tasks

작업이 현재 실행 중인 경우 프로젝트를 삭제하기 전에 작업을 취소합니다.

--yes -y

확인을 묻는 메시지를 표시하지 마세요.

Default value: False

전역 매개 변수

--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 dms project task list

프로젝트 내의 작업을 나열합니다. 일부 작업에는 알 수 없는 상태가 있을 수 있습니다. 이는 해당 작업의 상태를 쿼리하는 동안 오류가 발생했음을 나타냅니다.

az dms project task list --project-name
                         --resource-group
                         --service-name
                         [--task-type]

예제

프로젝트 내의 모든 작업을 나열합니다.

az dms project task list --project-name myproject -g myresourcegroup --service-name mydms

프로젝트 내에서 SQL 간 마이그레이션 작업만 나열합니다.

az dms project task list --project-name myproject -g myresourcegroup --service-name mydms --task-type Migrate.SqlServer.SqlDb

필수 매개 변수

--project-name

프로젝트의 이름입니다.

--resource-group -g

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

--service-name

서비스의 이름입니다.

선택적 매개 변수

--task-type

작업 유형별로 목록을 필터링합니다. 가능한 형식 목록은 "az dms check-status"를 참조하세요.

전역 매개 변수

--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 dms project task restart

전체 마이그레이션 또는 지정된 개체만 다시 시작합니다. 현재 MongoDB 마이그레이션에서만 지원됩니다.

요청 결과를 보려면 'task show' 명령을 사용하세요. az dms project task show ... --expand 명령.

az dms project task restart --name
                            --project-name
                            --resource-group
                            --service-name
                            [--object-name]

필수 매개 변수

--name -n

작업 이름입니다. DMS 프로젝트 작업은 마이그레이션 관련 작업을 수행하는 작업입니다. 프로젝트와 연결된 여러 작업이 있을 수 있습니다.

--project-name

프로젝트의 이름입니다. DMS 프로젝트는 원본 데이터베이스 연결, 대상 데이터베이스 연결 및 마이그레이션할 데이터베이스 목록을 포함하는 논리적 그룹화입니다.

--resource-group -g

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

--service-name

서비스의 이름입니다. DMS 서비스는 데이터베이스 마이그레이션을 수행하는 Azure 인스턴스입니다.

선택적 매개 변수

--object-name

다시 시작하려는 데이터베이스 또는 컬렉션의 정규화된 이름입니다. 전체 마이그레이션을 다시 시작하려면 비워 둡니다.

전역 매개 변수

--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 dms project task show

마이그레이션 작업의 세부 정보를 표시합니다. 자세한 내용을 보려면 "--expand"을 사용합니다.

az dms project task show --name
                         --project-name
                         --resource-group
                         --service-name
                         [--expand]

예제

마이그레이션 작업의 세부 정보를 표시합니다. 자세한 내용을 보려면 "--expand"을 사용합니다. (자동 생성됨)

az dms project task show --name MyTask --project-name MyProject --resource-group MyResourceGroup --service-name MyService

필수 매개 변수

--name -n

작업 이름입니다.

--project-name

프로젝트의 이름입니다.

--resource-group -g

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

--service-name

서비스의 이름입니다.

선택적 매개 변수

--expand

응답을 확장하여 자세한 정보를 제공합니다. "명령"과 함께 작업 세부 정보를 확인합니다. "출력"과 함께 작업 마이그레이션 결과를 확인합니다.

전역 매개 변수

--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 dms project task stop

작업을 중지하거나 지정된 개체에서 마이그레이션을 중지합니다(MongoDB 마이그레이션만 해당).

요청 결과를 보려면 'task show' 명령을 사용하세요. az dms project task show ... --expand 명령.

az dms project task stop --name
                         --project-name
                         --resource-group
                         --service-name
                         [--object-name]

필수 매개 변수

--name -n

작업 이름입니다. DMS 프로젝트 작업은 마이그레이션 관련 작업을 수행하는 작업입니다. 프로젝트와 연결된 여러 작업이 있을 수 있습니다.

--project-name

프로젝트의 이름입니다. DMS 프로젝트는 원본 데이터베이스 연결, 대상 데이터베이스 연결 및 마이그레이션할 데이터베이스 목록을 포함하는 논리적 그룹화입니다.

--resource-group -g

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

--service-name

서비스의 이름입니다. DMS 서비스는 데이터베이스 마이그레이션을 수행하는 Azure 인스턴스입니다.

선택적 매개 변수

--object-name

MongoDB 마이그레이션에서만 지원됩니다. 중지하려는 데이터베이스 또는 컬렉션의 정규화된 이름입니다. 전체 마이그레이션을 중지하려면 비워 둡니다.

전역 매개 변수

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