DACPAC を使用してMigration Assistantを使用してFabricの SQL データベースに移行する

適用対象: ✅Microsoft Fabric の SQL データベース

Fabric Migration Assistantでは、DACPAC ファイルからスキーマ メタデータをインポートし、Fabricのターゲット SQL データベースにデータをコピーする手順を説明します。

前提条件

開始する前に、次の前提条件が満たされていることを確認します。

• アクティブな容量を持つa Microsoft Fabric ワークスペースが必要です。
• ソース SQL Server インスタンスとMicrosoft Fabric間の通信には、オンプレミス データ ゲートウェイをインストールする必要があります。
  • 詳細については、「Microsoft Fabric の Data Factory でオンプレミス データ ソースへのアクセス」を参照してください。
  • ソース データベースに地理的に最も近いコンピューターにデータ ゲートウェイを登録します。
  • Fabric ポータルで、Settings>Manage 接続とゲートウェイ>オンプレミス データ ゲートウェイ に移動して、ゲートウェイが使用可能であることを確認します。
  • データ移行を開始する前に、新しく登録されたゲートウェイが一覧に表示され、準備完了状態になっていることを確認します。
• Fabric SQL 接続が作成され、ゲートウェイの使用が有効になっています。 移行コピー操作は、ゲートウェイ ランタイムを介して実行されます。 Fabric SQL接続でゲートウェイ使用が有効でない場合、データコピー操作は失敗します。
• ソース SQL Server データベースから生成された DACPAC ファイル。 .dacpac ファイルを生成する方法については、「データベースから DACPAC を抽出する」を参照してください。

Fabric接続で SQL データベースを作成する

オンプレミス データ ゲートウェイを登録したら、Fabric SQL 接続を作成し、ゲートウェイの使用に対して有効にします。

1. Microsoft Fabric ポータルで、Settings を選択します。 1. [ 接続とゲートウェイの管理] を選択し、[ 新規] を選択します。
2. [ 新しい接続 ] ウィンドウで、[ クラウド] を選択します。
3. 接続名を入力します。
4. Fabric の SQL データベース を接続タイプとして選択します。
5. OAuth 2.0 などの認証を構成します。
6. [接続設定] で、[ この接続をオンプレミス データ ゲートウェイまたは VNet データ ゲートウェイで使用できるようにする] を選択します。 移行コピー操作はゲートウェイ ランタイムを介して実行されるため、この設定が必要です。 ゲートウェイの使用に対して Fabric SQL 接続を有効にしない場合、データ コピー操作は失敗します。
7. [作成] を選択して接続を作成します。

Migration Assistantを起動する

オンプレミス データ ゲートウェイを構成し、Fabric SQL 接続を作成したら、Migration Assistantを開始する準備ができました。

1. Fabric ポータルで、ワークスペースに移動します。 ツール バーから Migrate を選択してMigration Assistantを起動します。
2. 「Migrate to Fabric」のペインで「Migrate to a database」の「SQL Server」を選択してください。
3. [ 概要 ] ページで、情報 を移行するときに想定される内容を 確認し、[ 次へ] を選択します。

手順 1: スキーマをコピーする

「ソースを選択し」で、ソースのSQL Server環境からDACPACファイルをアップロードします。

この段階が終わったら:

• 移行セッションが作成されます。
• スキーマ解析は自動的に開始されます。

ステップ2:スキーマの検証(任意)

1. DACPACファイルをアップロードした後、「ソースを選択する」で、宛先を設定する前にFabric SQL DatabaseとのDACPAC互換性を確認するために「検証」を選択してください。

   

2. Object Validation Summary(オブジェクト検証サマリー)を確認し、移行が期待されるオブジェクト、更新が必要なオブジェクト、または移行が期待されないオブジェクトを特定しましょう。

3. 移行を進める前に互換性の問題を修正してください。

ステップ3:スクリプトエラーの修正

Migration Assistantは DACPAC 内のスキーマ オブジェクトを分析し、Fabricの SQL データベースとの互換性に基づいて分類します。

as-is 移行できる内容と注意が必要な内容を明確に把握できるようになりました。 依存オブジェクトを移行するには、事前にプライマリ オブジェクトを解決する必要があります。 最初のスキーマ移行に失敗したデータベース オブジェクトの場合:

1. 移行されたオブジェクトと失敗したオブジェクトを表示します。 アシスタントで推奨される修正プログラムを確認します。
2. 非互換性の理由を確認します。 サポートされている変更を互換性のないオブジェクトに適用します。
3. 修正プログラムの適用後にオブジェクトを再検証します。

たとえば、T-SQL スクリプトの修正または回避策を提供するために、識別された構文の非互換性と [クエリ エラー の修正] ボタンが表示される場合があります。

ステップ4:コピーの準備

コピー の準備 手順では、新しい SQL データベースのデータベース スキーマを準備します。 スキーマは、Fabric コピー ジョブでのデータ移動の準備ができています。 この手順により、コピーの失敗が軽減され、データ移行中のパフォーマンスが向上します。

1. 生成された準備スクリプトをコピーします。
2. ターゲット SQL データベースに対してクエリ エディターでスクリプトを実行します。

ステップ5:データをコピーする

1. 5を選びます。 Migration Assistantでデータをコピーしてください。

2. コピー ジョブを使用する を選択します。 ジョブに名前を付け、[ 作成 ] を選択してジョブのコピー ウィザードを開きます。

3. ソース構成:

   [ データ ソースの選択] で、次の情報を入力します。

   1. ソースの種類として SQL Server database を選択します。
   2. ソース接続を選択または作成します。
   3. SQL Server インスタンスとデータベースの詳細を入力します。
   4. ソース SQL Server インスタンスへの接続に使用するオンプレミス データ ゲートウェイを選択します。
   5. 認証を選択します。 [組織アカウント] オプションを使用します。
   6. ソース SQL Server インスタンスで暗号化が有効になっていない場合は、設定で暗号化を無効にします。
   7. 次へを選択します。

4. テーブルを選択します。

   1. [ データの選択] で、移行するテーブルを選択します。
   2. (スキーマ移行から) ターゲット スキーマが既に存在するかどうかを確認し、[ 次へ] を選択します。

5. 確認と実行:

   1. 列マッピングを確認します。
   2. [コピー モード] を選択します。
   3. 概要を確認します。
   4. [保存と実行] を選びます。

6. モニター

   コピー ジョブの進行状況を監視するには、次の値を確認します。

   • 読み取られた行と書き込まれた行
   • テーブルごとの状態
   • 移行エラー (ある場合)

   エラーを解決し、必要に応じてテーブルを再実行します。

7. コピー ジョブが正常に完了したら、Migration Assistant に戻り、コピー データステップを完了としてマークします。

ステップ6:コピーの最終化

6。Finalize Copyステップはデータ移行を完了し、制約、トリガー、インデックスなどの残存項目を有効にして、データベースを望ましい状態に到達させます。

[コピーの最終処理] ウィンドウからクエリをコピーし、クエリ エディターで実行します。

この手順の最後に、ガイド付き移行エクスペリエンスが完了します。

移行後の考慮事項

移行が完了したら、次の手順を実行します。

• アプリケーションのクエリとワークロードを検証します。
• アプリケーション接続文字列を更新します。
• Fabric機能で SQL データベースのパフォーマンスと互換性を確認します。

関連するコンテンツ

• SQL データベース用のFabric Migration Assistant
• Microsoft Fabric 移行の概要