az datamigration
Note
このリファレンスは、Azure CLI (バージョン 2.15.0 以降) のデータマイグレーション拡張機能の一部です。 拡張機能は、az datamigration コマンドを初めて実行するときに自動的にインストールされます。 拡張機能の詳細をご覧ください。
データ移行を管理します。
コマンド
名前 | 説明 | 型 | 状態 |
---|---|---|---|
az datamigration get-assessment |
SQL Server インスタンスで評価を開始します。 |
拡張機能 | GA |
az datamigration get-sku-recommendation |
Azure SQL オファリングの SKU に関する推奨事項を提供します。 |
拡張機能 | GA |
az datamigration login-migration |
ソース Sql Server からターゲットの Azure Sql Server にログインを移行します。 |
拡張機能 | GA |
az datamigration performance-data-collection |
特定の SQL Server インスタンスのパフォーマンス データを収集します。 |
拡張機能 | GA |
az datamigration register-integration-runtime |
統合ランタイムに Database Migration Service を登録します。 |
拡張機能 | GA |
az datamigration sql-db |
SQL DB へのデータベース移行を管理します。 |
拡張機能 | GA |
az datamigration sql-db cancel |
SQL DB への進行中のデータベース移行を停止します。 |
拡張機能 | 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 |
拡張機能 | GA |
az datamigration sql-db delete |
SQL DB への進行中または完了したデータベースの移行を削除します。 |
拡張機能 | GA |
az datamigration sql-db show |
特定の SQL DB の指定されたデータベース移行を取得します。 |
拡張機能 | GA |
az datamigration sql-db wait |
datamigration sql-db の条件が満たされるまで、CLI を待機状態にします。 |
拡張機能 | GA |
az datamigration sql-managed-instance |
SQL Managed Instance へのデータベース移行を管理します。 |
拡張機能 | GA |
az datamigration sql-managed-instance cancel |
SQL Managed Instance への進行中のデータベース移行を停止します。 |
拡張機能 | GA |
az datamigration sql-managed-instance create |
特定の SQL Managed Instance への新しいデータベース移行を作成します。 |
拡張機能 | GA |
az datamigration sql-managed-instance cutover |
SQL Managed Instance への進行中のオンライン データベース移行のカットオーバーを開始します。 |
拡張機能 | GA |
az datamigration sql-managed-instance show |
特定の SQL Managed Instance の指定されたデータベース移行を取得します。 |
拡張機能 | GA |
az datamigration sql-managed-instance wait |
datamigration sql-managed-instance の条件が満たされるまで、CLI を待機状態にします。 |
拡張機能 | GA |
az datamigration sql-server-schema |
ソース Sql Server からターゲットの Azure Sql Server にスキーマを移行します。 |
拡張機能 | GA |
az datamigration sql-service |
データベース移行サービスを管理します。 |
拡張機能 | GA |
az datamigration sql-service create |
データベース移行サービスを作成します。 |
拡張機能 | GA |
az datamigration sql-service delete |
データベース移行サービスを削除します。 |
拡張機能 | GA |
az datamigration sql-service delete-node |
統合ランタイム ノードを削除します。 |
拡張機能 | GA |
az datamigration sql-service list |
リソース グループ内のすべての Database Migration Services を取得します。 また、サブスクリプション内のすべての Database Migration Services を取得します。 |
拡張機能 | GA |
az datamigration sql-service list-auth-key |
セルフホステッド統合ランタイムの認証キーの一覧を取得します。 |
拡張機能 | GA |
az datamigration sql-service list-integration-runtime-metric |
特定の Database Migration Service の登録済みの Integration Runtine ノードとその監視データを取得します。 |
拡張機能 | GA |
az datamigration sql-service list-migration |
サービスにアタッチされているデータベース移行の一覧を取得します。 |
拡張機能 | GA |
az datamigration sql-service regenerate-auth-key |
セルフホステッド統合ランタイムの認証キーの新しいセットを再生成します。 |
拡張機能 | GA |
az datamigration sql-service show |
データベース移行サービスを取得します。 |
拡張機能 | GA |
az datamigration sql-service update |
データベース移行サービスを更新します。 |
拡張機能 | GA |
az datamigration sql-service wait |
datamigration sql-service の条件が満たされるまで、CLI を待機状態にします。 |
拡張機能 | GA |
az datamigration sql-vm |
SQL VM へのデータベース移行を管理します。 |
拡張機能 | GA |
az datamigration sql-vm cancel |
SQL VM への進行中のデータベース移行を停止します。 |
拡張機能 | GA |
az datamigration sql-vm create |
特定の SQL VM への新しいデータベース移行を作成します。 |
拡張機能 | GA |
az datamigration sql-vm cutover |
進行中のオンライン データベースを SQL VM に移行するためのカットオーバーを開始します。 |
拡張機能 | GA |
az datamigration sql-vm show |
特定の SQL VM の指定されたデータベース移行を取得します。 |
拡張機能 | GA |
az datamigration sql-vm wait |
datamigration sql-vm の条件が満たされるまで、CLI を待機状態にします。 |
拡張機能 | GA |
az datamigration tde-migration |
ソース SQL Server からターゲットの Azure SQL Server に TDE 証明書を移行します。 |
拡張機能 | GA |
az datamigration get-assessment
SQL Server インスタンスで評価を開始します。
az datamigration get-assessment [--config-file-path]
[--connection-string]
[--output-folder]
[--overwrite]
例
接続文字列を使用して、特定の SQL Server で SQL Assessment を実行します。
az datamigration get-assessment --connection-string "Data Source=LabServer.database.net;Initial Catalog=master;Integrated Security=False;User Id=User;Password=password" --output-folder "C:\AssessmentOutput" --overwrite
評価構成ファイルを使用して、特定の SQL Server で SQL Assessment を実行します。
az datamigration get-assessment --config-file-path "C:\Users\user\document\config.json"
接続文字列を使用して、1 回の呼び出しで複数の SQL Server で SQL Assessment を実行します。
az datamigration get-assessment --connection-string "Data Source=LabServer1.database.net;Initial Catalog=master;Integrated Security=False;User Id=User;Password=password" "Data Source=LabServer2.database.net;Initial Catalog=master;Integrated Security=False;User Id=User;Password=password" --output-folder "C:\AssessmentOutput" --overwrite
省略可能のパラメーター
ConfigFile のパス。
SQL Server 接続文字列。
評価レポートを格納する出力フォルダー。
既存の評価レポートを上書きするには、このパラメーターを有効にします。
グローバル パラメーター
すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告は抑制します。
出力形式。
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。
サブスクリプションの名前または ID。 az account set -s NAME_OR_ID
を使用して、既定のサブスクリプションを構成できます。
ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。
az datamigration get-sku-recommendation
Azure SQL オファリングの SKU に関する推奨事項を提供します。
az datamigration get-sku-recommendation [--config-file-path]
[--database-allow-list]
[--database-deny-list]
[--display-result]
[--elastic-strategy]
[--end-time]
[--output-folder]
[--overwrite]
[--scaling-factor]
[--start-time]
[--target-percentile]
[--target-platform]
[--target-sql-instance]
例
コマンド ラインを使用して、特定の SQL Server の SKU に関する推奨事項を取得します。
az datamigration get-sku-recommendation --output-folder "C:\PerfCollectionOutput" --database-allow-list AdventureWorks1 AdventureWorks2 --display-result --overwrite
評価構成ファイルを使用して、特定の SQL Server の SKU に関する推奨事項を取得します。
az datamigration get-sku-recommendation --config-file-path "C:\Users\user\document\config.json"
省略可能のパラメーター
ConfigFile のパス。
SKU に関する推奨事項の検討に使用できるデータベースの名前のスペース区切りの一覧。それ以外はすべて除外します。 databaseAllowList と databaseDenyList のどちらかを設定するか、またはどちらも設定しません。 既定値は null 値です。
SKU の推奨事項では考慮されないデータベースの名前のスペース区切りリスト。 databaseAllowList と databaseDenyList のどちらかを設定するか、またはどちらも設定しません。 既定値は null 値です。
SKU 推奨結果をコンソールに出力するかどうか。 結果を表示するには、このパラメーターを有効にします。
リソース使用量プロファイルに基づく SKU の推奨事項に対してエラスティック戦略を使用するかどうか。 エラスティック戦略を使用するには、このパラメーターを有効にします。
集計中に考慮するパフォーマンス データの UTC 終了時刻 (YYYY-MM-DD HH:MM 形式)。 ベースライン (非エラスティック) 戦略にのみ使われます。 既定値: 収集されたすべてのデータ ポイントが考慮されます。
SQL Server のパフォーマンス データが格納されている出力フォルダー。 ここでの値は、PerfDataCollection で使用される値と同じである必要があります。
既存の SKU レコメンデーション レポートを上書きするかどうか。 このパラメーターを有効にして上書きします。
SKU 推奨の間に使用されるスケーリング (快適性) 係数。 たとえば、スケーリング計数 150% で 4 仮想コア CPU の要件があると判断された場合、実際の CPU 要件は 6 仮想コアになります。
集計中に考慮するパフォーマンス データポイントの UTC 開始時刻 (YYYY-MM-DD HH:MM 形式)。 ベースライン (非エラスティック) 戦略にのみ使われます。 既定値: 収集されたすべてのデータ ポイントが考慮されます。
パフォーマンス データの集計中に使用されるデータ ポイントのパーセンタイル。 ベースライン (非エラスティック) 戦略にのみ使われます。
SKU の推奨事項のターゲット プラットフォーム: AzureSqlDatabase、AzureSqlManagedInstance、AzureSqlVirtualMachine、または Any。 [いずれか] が選択されている場合、3 つのターゲット プラットフォームすべてに対する SKU の推奨事項が評価され、最適な値が返されます。
SKU を推奨する SQL インスタンスの名前。 既定値: PerfDataCollection アクションによって作成されたファイルについては outputFolder がスキャンされ、見つかったすべてのインスタンスに対して推奨事項が提供されます。
グローバル パラメーター
すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告は抑制します。
出力形式。
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。
サブスクリプションの名前または ID。 az account set -s NAME_OR_ID
を使用して、既定のサブスクリプションを構成できます。
ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。
az datamigration login-migration
ソース Sql Server からターゲットの Azure Sql Server にログインを移行します。
az datamigration login-migration [--aad-domain-name]
[--config-file-path]
[--csv-file-path]
[--list-of-login]
[--output-folder]
[--src-sql-connection-str]
[--tgt-sql-connection-str]
例
パラメーターを使用して、移行元の Sql Server からターゲットの Azure Sql Server へのログインの移行を実行します。
az datamigration login-migration --src-sql-connection-str "data source=servername;user id=userid;password=;initial catalog=master;TrustServerCertificate=True" --tgt-sql-connection-str "data source=servername;user id=userid;password=;initial catalog=master;TrustServerCertificate=True" --csv-file-path "C:\CSVFile" --list-of-login "loginname1" "loginname2" --output-folder "C:\OutputFolder" --aad-domain-name "AADDomainName"
構成ファイルを使用して、移行元の Sql Server からターゲットの Azure Sql Server へのログインの移行を実行します。
az datamigration login-migration --config-file-path "C:\Users\user\document\config.json"
省略可能のパラメーター
移行するログインの一覧に Windows ログインが含まれている場合は必須です。
ConfigFile のパス。
ログインの CSV ファイルの場所。 このパラメーターと listOfLogin の間で使用するパラメーターは 1 つだけです。
文字列形式のログインの一覧。 多数のログインを移行する必要がある場合は、CSV ファイル オプションを使用します。
既定値: %LocalAppData%/Microsoft/SqlLoginMigrations) ログが書き込まれるフォルダー。
正式な接続文字列形式を使用するソース SQL インスタンスの接続文字列。
正式な接続文字列形式を使用するターゲット SQL インスタンスの接続文字列。
グローバル パラメーター
すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告は抑制します。
出力形式。
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。
サブスクリプションの名前または ID。 az account set -s NAME_OR_ID
を使用して、既定のサブスクリプションを構成できます。
ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。
az datamigration performance-data-collection
特定の SQL Server インスタンスのパフォーマンス データを収集します。
az datamigration performance-data-collection [--config-file-path]
[--connection-string]
[--number-of-iteration]
[--output-folder]
[--perf-query-interval]
[--static-query-interval]
[--time]
例
接続文字列を使用して、特定の SQL Server のパフォーマンス データを収集します。
az datamigration performance-data-collection --connection-string "Data Source=LabServer.database.net;Initial Catalog=master;Integrated Security=False;User Id=User;Password=password" --output-folder "C:\PerfCollectionOutput" --number-of-iteration 5 --perf-query-interval 10 --static-query-interval 60
接続文字列を使用して、1 回の呼び出しで複数の SQL Server のパフォーマンス データを収集します。
az datamigration performance-data-collection --connection-string "Data Source=LabServer1.database.net;Initial Catalog=master;Integrated Security=False;User Id=User;Password=password" "Data Source=LabServer2.database.net;Initial Catalog=master;Integrated Security=False;User Id=User;Password=password" --output-folder "C:\PerfCollectionOutput" --number-of-iteration 5 --perf-query-interval 10 --static-query-interval 60
評価構成ファイルを使用して、特定の SQL Server のパフォーマンス データを収集します。
az datamigration performance-data-collection --config-file-path "C:\Users\user\document\config.json"
制限時間を指定して、特定の SQL Server のパフォーマンス データを収集します。 指定された時間制限がイテレーション サイクルの構成より前の場合、プロセスは最後のサイクル パフォーマンス データを保存せずに終了します。
az datamigration performance-data-collection --connection-string "Data Source=LabServer.database.net;Initial Catalog=master;Integrated Security=False;User Id=User;Password=password" --output-folder "C:\PerfCollectionOutput" --number-of-iteration 5 --perf-query-interval 10 --static-query-interval 60 --time 60
省略可能のパラメーター
ConfigFile のパス。
SQL Server 接続文字列。
ファイルに保持する前に実行するパフォーマンス データ収集の反復回数。 たとえば、既定値では、パフォーマンス データは 30 秒ごとに 20 回分、つまり 10 分保持されます。 最小値: 2。
パフォーマンス データを格納する出力フォルダー。
パフォーマンス データのクエリを実行する間隔 (秒単位)。
静的構成データのクエリを実行して保持する間隔 (秒単位)。
コマンドの実行が自動的に停止する時間 (秒単位)。 このパラメーターが指定されていない場合は、コマンドの実行を停止するために手動による介入が必要になります。
グローバル パラメーター
すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告は抑制します。
出力形式。
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。
サブスクリプションの名前または ID。 az account set -s NAME_OR_ID
を使用して、既定のサブスクリプションを構成できます。
ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。
az datamigration register-integration-runtime
統合ランタイムに Database Migration Service を登録します。
az datamigration register-integration-runtime --auth-key
[--installed-ir-path]
[--ir-path]
例
セルフホステッド統合ランタイムに Sql Migration Service を登録します。
az datamigration register-integration-runtime --auth-key "IR@00000-0000000-000000-aaaaa-bbbb-cccc"
統合ランタイムをインストールし、それに Sql Migration Service を登録します。
az datamigration register-integration-runtime --auth-key "IR@00000-0000000-000000-aaaaa-bbbb-cccc" --ir-path "C:\Users\user\Downloads\IntegrationRuntime.msi"
特定のインストール場所から統合ランタイムを読み取ります。
az datamigration register-integration-runtime --auth-key "IR@00000-0000000-000000-aaaaa-bbbb-cccc" --installed-ir-path "D:\My Softwares\Microsoft Integration Runtime\5.0"
必須のパラメーター
SQL Migration Service の AuthKey。
省略可能のパラメーター
Integration Runtime のインストール場所のバージョン フォルダー パス。 これは、IR がインストールされているが、コマンドが読み取りに失敗した場合に提供できます。 形式: "\Microsoft Integration Runtime<Version>"。
統合ランタイム MSI のパス。
グローバル パラメーター
すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告は抑制します。
出力形式。
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。
サブスクリプションの名前または ID。 az account set -s NAME_OR_ID
を使用して、既定のサブスクリプションを構成できます。
ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。
az datamigration sql-server-schema
ソース Sql Server からターゲットの Azure Sql Server にスキーマを移行します。
az datamigration sql-server-schema [--action {DeploySchema, GenerateScript, MigrateSchema}]
[--config-file-path]
[--input-script-file-path]
[--output-folder]
[--src-sql-connection-str]
[--tgt-sql-connection-str]
例
パラメーターを使用して、ソース SQL Server からターゲットの Azure SQL Database にデータベース オブジェクトを移行するを実行します。
az datamigration sql-server-schema --action "MigrateSchema" --src-sql-connection-str "Server=;Initial Catalog=;User ID=;Password=" --tgt-sql-connection-str "Server=;Initial Catalog=;User ID=;Password="
パラメーターを使用して、ソース SQL Server から TSQL スキーマの生成スクリプトを実行します。
az datamigration sql-server-schema --action "GenerateScript" --src-sql-connection-str "Server=;Initial Catalog=;User ID=;Password=" --tgt-sql-connection-str "Server=;Initial Catalog=;User ID=;Password=" --output-folder "C:\OutputFolder"
パラメーターを使用して、ターゲットの Azure SQL Database に TSQL スクリプトをデプロイします。
az datamigration sql-server-schema --action "GenerateScript" --src-sql-connection-str "Server=;Initial Catalog=;User ID=;Password=" --tgt-sql-connection-str "Server=;Initial Catalog=;User ID=;Password=" --input-script-file-path "C:\OutputFolder\script.sql"
ConfigFile を使用して、ソース SQL Server からターゲット Azure SQL Database へのデータベース オブジェクトの移行を実行します。
az datamigration sql-server-schema --config-file-path "C:\configfile.json"
省略可能のパラメーター
1 つのスキーマ移行アクションを選択します。 MigrateSchema は、データベース オブジェクトを Azure SQL Database ターゲットに移行することです。 GenerateScript は、オブジェクトをデプロイするためにターゲットで実行するために使用できる編集可能な TSQL スキーマ スクリプトを生成することです。 DeploySchema は、ターゲットで -GenerateScript アクションから生成された TSQL スクリプトを実行してオブジェクトをデプロイすることです。
ConfigFile のパス。 configfile.jsonで受け入れられるパラメーター名は、Action、sourceConnectionString、targetConnectionString、inputScriptFilePath、outputFolder です。
編集可能な TSQL スキーマ スクリプトの場所。 このパラメーターは、DeploySchema アクションでのみ使用してください。
既定値: %LocalAppData%/Microsoft/SqlSchemaMigration) ログが書き込まれるフォルダーと、GenerateScript アクションによって生成された TSQL スキーマ スクリプト。
正式な接続文字列形式を使用した、ソース SQL インスタンスの接続文字列。
正式な接続文字列形式を使用した、ターゲット SQL インスタンスの接続文字列。
グローバル パラメーター
すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告は抑制します。
出力形式。
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。
サブスクリプションの名前または ID。 az account set -s NAME_OR_ID
を使用して、既定のサブスクリプションを構成できます。
ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。
az datamigration tde-migration
ソース SQL Server からターゲットの Azure SQL Server に TDE 証明書を移行します。
az datamigration tde-migration [--database-name]
[--network-share-domain]
[--network-share-password]
[--network-share-path]
[--network-share-user-name]
[--source-sql-connection-string]
[--target-managed-instance-name]
[--target-resource-group-name]
[--target-subscription-id]
例
ソース SQL Server からターゲットの Azure SQL Server に TDE 証明書を移行します。
az datamigration tde-migration --source-sql-connection-string "data source=servername;user id=userid;password=;initial catalog=master;TrustServerCertificate=True" --target-subscription-id "00000000-0000-0000-0000-000000000000" --target-resource-group-name "ResourceGroupName" --target-managed-instance-name "TargetManagedInstanceName" --network-share-path "\NetworkShare\Folder" --network-share-domain "NetworkShare" --network-share-user-name "NetworkShareUserName" --network-share-password "" --database-name "TdeDb_0" "TdeDb_1" "TdeDb_2"
省略可能のパラメーター
ソース データベース名。
ネットワーク共有はメインします。
ネットワーク共有のパスワード。
ネットワーク共有パス。
ネットワーク共有のユーザー名。
正式な接続文字列形式を使用した、ソース SQL インスタンスの接続文字列。
Azure SQL Server の名前。
ターゲットの Azure SQL サーバーのリソース グループ名。
ターゲットの Azure SQL サーバーのサブスクリプション ID。
グローバル パラメーター
すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告は抑制します。
出力形式。
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。
サブスクリプションの名前または ID。 az account set -s NAME_OR_ID
を使用して、既定のサブスクリプションを構成できます。
ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。
Azure CLI