適用対象: Microsoft Fabric の✅ Warehouse
Fabric Migration Assistant は、ネイティブに Fabric に組み込まれた移行エクスペリエンスであり、Microsoft Fabric へのガイド付き移行エクスペリエンスを提供します。
Migration Assistant は、ソース データベースからメタデータとデータをコピーし、ソース スキーマを Fabric Data Warehouse 用に自動的に変換します。 AI 搭載サポートにより、移行の非互換性やエラーに対する迅速な解決策が提供されます。
ヒント
移行アシスタントを使用した移行の詳細なガイドについては、「 Data Warehouse 用 Fabric Migration Assistant を使用した移行」を参照してください。
移行の戦略と計画の詳細については、移行の計画:Azure Synapse Analytics 専用 SQL プールから Fabric Data Warehouse に関するページを参照してください。
移行の手順
Fabric Migration Assistant を使用した移行には、おおまかに次の手順が含まれます。
- DACPAC ファイルを使用して、オブジェクトのスキーマ (テーブルの定義など) をソースから新しい Fabric ウェアハウスに移行します。
- Migration Assistant を使用して、自動的に移行できなかったオブジェクトの T-SQL 型と定義を更新することで、問題を修正します。
- Fabric Data Factory のコピー ジョブを使用してデータをコピーします。
- 古いウェアハウスと新しいウェアハウスのテストと並列比較を行います。 最後に、ソース ウェアハウスにアクセスするアプリケーションからの接続を新しいウェアハウスに向けて再ルーティングします。
移行されるオブジェクト
Migration Assistant は、ユーザーが DACPAC ファイルを使用して Fabric ウェアハウスに移行するのを支援します。 DACPAC 内でキャプチャされるデータベース オブジェクトメタデータは次のとおりです。
- 表
- 見解
- 関数
- ストアド プロシージャ
- ロール、アクセス許可、動的データ マスクなどのセキュリティ オブジェクト
Migration Assistant を使用して問題を修正します
メタデータを Fabric ウェアハウスでサポートされているメタデータに移行できなかった場合、またはコードを T-SQL に適用できなかった場合、一部の T-SQL スクリプトが移行に失敗します。 Migration Assistant の問題の修正手順は、これらの失敗したスクリプトを修正するのに役立ちます。
プライマリ オブジェクトと依存オブジェクト
失敗したスクリプトは次のセットに分割されます。
- プライマリ オブジェクトは、別のオブジェクトに依存しないオブジェクトです。
- 依存オブジェクトは、直接的または間接的に 1 つ以上のオブジェクトに依存するオブジェクトです。
依存オブジェクトは、プライマリ オブジェクトが修正されるまで移行されないため、まずプライマリ オブジェクトを修正することが推奨されます。
たとえば、テーブル A、テーブル A を使用するビュー B、ビュー B を使用するビュー C の 3 つのオブジェクトがあるとします。この場合、プライマリ オブジェクトはテーブル A です。ビュー B と C は依存オブジェクトです。
移行をより迅速に完了できるように、プライマリ オブジェクトは優先順位に従って並べ替えられます。 優先順位は、そのオブジェクトの依存関係の数に基づいています。 依存関係とは、直接的または間接的に、このオブジェクトを参照するか、このオブジェクトに依存しているオブジェクトを指します。
たとえば、テーブル A はビュー B と C に 2 つの依存関係を持ち、ビュー B はビュー C に 1 つの依存関係を持ち、ビュー C には依存関係がありません。 そのため、テーブル A、ビュー B、ビュー C の順に優先順位に従って並べ替えられます。
移行エラーを修正する
エラー情報を手動で使用して破損したスクリプトを確認して修正するか、Copilot で AI 搭載サポートを使用します。 (Copilot は有効にする必要があります。)Copilot はクエリを分析し、最適な修正方法を見つけようとします。 Copilot は、修正内容とその理由を説明するコメントを残します。 Copilot は AI を使用しているため、間違いが発生する可能性があるので、コードを実行する前に提案内容を確認してください。
クエリを実行するために必要な調整を行うと、Migration Assistant がオブジェクトとその依存関係を検証して移行します。 修正されたオブジェクトが移行されると、[Primary objects] (プライマリ オブジェクト) タブが更新されて、優先順位付けされたオブジェクトの新しい一覧が表示されます。 プライマリ オブジェクトを修正しても、プライマリ オブジェクトの数が同じままであることがあり、増えることさえあります。 たとえば、オブジェクト B の破損の理由が、オブジェクト A を含む他の複数の破損したオブジェクトに依存していることであるとします。このシナリオでは、オブジェクト A を修正しても、B で修正されるのはすべてではなく一部のエラーであるため、B が依存オブジェクトからプライマリ オブジェクトに変更されます。
安全
ロール、アクセス許可 (GRANT/REVOKE/DENY など)、動的データ マスクなどの、ほとんどの種類のセキュリティ オブジェクトは自動的に移行されると予期されています。 一部のオブジェクト (SQL 認証ユーザーや列レベルの暗号化など) は、Fabric で動作するには更新が必要です。 これらの問題には、Migration Assistant の [Fix problems] (問題の修正) 一覧でフラグが付けられます。
SQL 認証ユーザーは、Microsoft Fabric 内の Microsoft Entra ユーザーに置き換える必要があります。 Microsoft Entra ID 経由で Fabric にサインインできることを確認してから、[アクセス許可の管理] を使用するか、[共有] ダイアログを使用して Fabric のウェアハウスに追加します。 ユーザーを追加するには、管理者/メンバーに "再共有" アクセス許可が必要です。
データをコピーする前に、機密情報に対する意図しないアクセス権をユーザーが持たないようにするため、移行に失敗したセキュリティ オブジェクトを修正し、必要なセキュリティが設定されていることを確認してください。
制限事項
現時点では、ソース ウェアハウスと Fabric ウェアハウスの間に完全な T-SQL 互換性はありません。 詳細については、以下を参照してください。
サポートされていない一般的な機能の回避策を次に示します。
| 問題点 | 回避策 |
|---|---|
| SQL 認証 | SQL 認証ユーザーは、SQL 認証の代替手段の Microsoft Entra 認証を使用して置き換えます。 |
| 列レベルの暗号化 | データを保護するには、アプリケーション レイヤーでの暗号化の実装や、機密データを難読化するための Fabric データ ウェアハウスでの動的データ マスクなどの代替方法を使用します。 |
| スカラー関数 | スカラー ユーザー定義関数 (UDF) は現在、Migration Assistant によって移行されていません。 スカラー UDF は Fabric Data Warehouse でサポートされますが、インライン化可能な場合にのみサポートされます (現在プレビュー段階)。 詳細については、 CREATE FUNCTION と スカラー UDF のインライン化に関する説明を参照してください。 |
| ID 列 | 一意の識別子を割り当てる代替手段を使用します。 例については、「Microsoft Fabric のウェアハウス テーブルで一意識別子を生成する」を参照してください |
| 一時テーブル | 通常のテーブルを使用します。 |
Microsoft Fabric Data Warehouse では、次のサポートされていない機能が不要になりました。
- 索引
- Transparent Data Encryption (TDE): Fabric はより高度な手段でデータを既に暗号化しているため、Fabric では不要です。
現在サポートされていないその他の機能で、表示される可能性があるものは次のとおりです。
- 外部テーブル
- 複数ステートメント テーブル値関数 (TVF)