az datamigration
手記
このリファレンスは、Azure CLI (バージョン 2.15.0 以降) の datamigration 拡張機能の一部です。 az datamigration コマンドを初めて実行すると、拡張機能が自動的にインストールされます。 拡張機能の詳細については、 を参照してください。
データ移行を管理します。
コマンド
名前 | 説明 | 型 | 状態 |
---|---|---|---|
az datamigration get-assessment |
SQL Server インスタンスで評価を開始します。 |
延長 | ジョージア 州 |
az datamigration get-sku-recommendation |
Azure SQL オファリングの SKU に関する推奨事項を提供します。 |
延長 | ジョージア 州 |
az datamigration login-migration |
ソース Sql Server からターゲットの Azure Sql Server にログインを移行します。 |
延長 | ジョージア 州 |
az datamigration performance-data-collection |
特定の SQL Server インスタンスのパフォーマンス データを収集します。 |
延長 | ジョージア 州 |
az datamigration register-integration-runtime |
統合ランタイムに Database Migration Service を登録します。 |
延長 | ジョージア 州 |
az datamigration sql-db |
SQL DB へのデータベース移行を管理します。 |
延長 | ジョージア 州 |
az datamigration sql-db cancel |
SQL DB への進行中のデータベース移行を停止します。 |
延長 | ジョージア 州 |
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 delete |
SQL DB への進行中または完了したデータベースの移行を削除します。 |
延長 | ジョージア 州 |
az datamigration sql-db show |
特定の SQL DB の指定されたデータベース移行を取得します。 |
延長 | ジョージア 州 |
az datamigration sql-db wait |
datamigration sql-db の条件が満たされるまで、CLI を待機状態にします。 |
延長 | ジョージア 州 |
az datamigration sql-managed-instance |
SQL Managed Instance へのデータベース移行を管理します。 |
延長 | ジョージア 州 |
az datamigration sql-managed-instance cancel |
SQL Managed Instance への進行中のデータベース移行を停止します。 |
延長 | ジョージア 州 |
az datamigration sql-managed-instance create |
特定の SQL Managed Instance への新しいデータベース移行を作成します。 |
延長 | ジョージア 州 |
az datamigration sql-managed-instance cutover |
SQL Managed Instance への進行中のオンライン データベース移行のカットオーバーを開始します。 |
延長 | ジョージア 州 |
az datamigration sql-managed-instance show |
特定の SQL Managed Instance の指定されたデータベース移行を取得します。 |
延長 | ジョージア 州 |
az datamigration sql-managed-instance wait |
datamigration sql-managed-instance の条件が満たされるまで、CLI を待機状態にします。 |
延長 | ジョージア 州 |
az datamigration sql-server-schema |
ソース Sql Server からターゲットの Azure Sql Server にスキーマを移行します。 |
延長 | ジョージア 州 |
az datamigration sql-service |
データベース移行サービスを管理します。 |
延長 | ジョージア 州 |
az datamigration sql-service create |
データベース移行サービスを作成します。 |
延長 | ジョージア 州 |
az datamigration sql-service delete |
データベース移行サービスを削除します。 |
延長 | ジョージア 州 |
az datamigration sql-service delete-node |
統合ランタイム ノードを削除します。 |
延長 | ジョージア 州 |
az datamigration sql-service list |
リソース グループ内のすべての Database Migration Services を取得します。 また、サブスクリプション内のすべての Database Migration Services を取得します。 |
延長 | ジョージア 州 |
az datamigration sql-service list-auth-key |
セルフホステッド統合ランタイムの認証キーの一覧を取得します。 |
延長 | ジョージア 州 |
az datamigration sql-service list-integration-runtime-metric |
特定の Database Migration Service の登録済みの Integration Runtine ノードとその監視データを取得します。 |
延長 | ジョージア 州 |
az datamigration sql-service list-migration |
サービスにアタッチされているデータベース移行の一覧を取得します。 |
延長 | ジョージア 州 |
az datamigration sql-service regenerate-auth-key |
セルフホステッド統合ランタイムの認証キーの新しいセットを再生成します。 |
延長 | ジョージア 州 |
az datamigration sql-service show |
データベース移行サービスを取得します。 |
延長 | ジョージア 州 |
az datamigration sql-service update |
データベース移行サービスを更新します。 |
延長 | ジョージア 州 |
az datamigration sql-service wait |
datamigration sql-service の条件が満たされるまで、CLI を待機状態にします。 |
延長 | ジョージア 州 |
az datamigration sql-vm |
SQL VM へのデータベース移行を管理します。 |
延長 | ジョージア 州 |
az datamigration sql-vm cancel |
SQL VM への進行中のデータベース移行を停止します。 |
延長 | ジョージア 州 |
az datamigration sql-vm create |
特定の SQL VM への新しいデータベース移行を作成します。 |
延長 | ジョージア 州 |
az datamigration sql-vm cutover |
進行中のオンライン データベースを SQL VM に移行するためのカットオーバーを開始します。 |
延長 | ジョージア 州 |
az datamigration sql-vm show |
特定の SQL VM の指定されたデータベース移行を取得します。 |
延長 | ジョージア 州 |
az datamigration sql-vm wait |
datamigration sql-vm の条件が満たされるまで、CLI を待機状態にします。 |
延長 | ジョージア 州 |
az datamigration tde-migration |
ソース SQL Server からターゲットの Azure SQL Server に TDE 証明書を移行します。 |
延長 | ジョージア 州 |
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%の仮想コア CPU 要件が 4 つあると判断された場合、真の 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 がインストールされているが、コマンドが読み取りに失敗した場合に提供できます。 形式: <Parent-folder-path>\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 は、ターゲット上のアクションから生成された TSQL スクリプト -GenerateScript 実行して、オブジェクトをデプロイすることです。
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