Power BIおよびFabricでの ODBC から ADBC ドライバーへの移行

Power BIとMicrosoft Fabricは、サポートされているデータ ソース接続を従来の埋め込み ODBC ドライバーから Apache Arrow Database Connectivity (ADBC) ドライバーに移行しています。 ADBC には、方向データを操作するための一連の標準インターフェイスが用意されています。これは、オーバーヘッドを最小限に抑え、シリアル化やコピーなしで大規模なデータセットをフェッチする場合に特に効率的です。 ADBC ドライバーには、メモリの安全性やガベージ コレクションなどのセキュリティ強化も組み込まれています。

Note

この記事で説明するテナントとワークスペースのコントロールは段階的に有効になっており、すべてのテナントではまだ使用できない場合があります。 この遷移は、この記事に記載されているコネクタにのみ適用され、別にインストールされた ODBC ドライバーを使用する場合の ODBC コネクタの動作は変更されません。 この記事の変更点は、Power BIに付属する埋め込みドライバーからの移行です。

現在、接続ごとに ADBC を導入できます。管理者は、ワークスペース管理者がテストと検証のためにオーバーライドできるテナント設定を使用して、既定の動作を大規模に制御できます。

コネクタとドライバーの変更

次の表に、埋め込み ODBC ドライバーから代替ドライバーに移行するコネクタの一覧を示します。 ほとんどの場合、代替ドライバーは ADBC ドライバーです。

コネクタ 現在のドライバー 交換用ドライバ
Databricks Simba Spark ODBC Databricks ADBC
Azure Databricks Simba Spark ODBC Databricks ADBC
Dremio Simba Drill ODBC FlightSQL ADBC
Google BigQuery と Google BigQuery (Microsoft Entra ID) Simba Google BigQuery ODBC BigQuery ADBC
Hive Simba Hive ODBC 廃止
Impala Simba Impala ODBC HiveServer2 ADBC
Snowflake Simba Snowflake ODBC Snowflake ADBC
Spark Simba Spark ODBC HiveServer2 ADBC

影響を受けるユーザー

ADBC に移行するコネクタ (Databricks、Snowflake、Google BigQuery など) を使用すると、次のような影響を受けます。

  • 接続で実装を明示的に選択していない ( Implementation パラメーターが指定されていない) か、
  • 組織では、サポートされているコネクタの既定値が ADBC か ODBC かを一元的に制御したいと考えています。

この既定値は、セマンティック モデル、データフロー Gen2、ページ分割されたレポートなど、接続を作成する場所であればどこでも適用されます。

移行方法

必要な制御の量に応じて、次の 3 つの方法で移行できます。

Note

[テナント設定] オプションと [ワークスペースのオーバーライド] オプションは、Dataflows Gen1 には影響しません。 Dataflows Gen1 で ADBC ドライバーを使用するには、個々のクエリに Implementation="2.0" を追加する必要があります。

接続ごとのオプトイン

ADBC にオプトインするには、サポートされている接続に Implementation="2.0" を追加します。 この方法では、個々の接続に対して独自のペースで ADBC を検証できます。

特定のコネクタの接続ごとのオプトインの詳細な手順については、「コネクタ とドライバーの変更 」の表にリンクされているコネクタ固有のドキュメントを参照してください。

テナント設定

テナント管理者は、管理ポータルの設定を使用して、組織の既定値を設定できます。

ユーザーは、Apache Arrow データベース接続 (ADBC) を使用してデータ ソースに接続できます

  • 無効 (既定値): 従来の ODBC ドライバーを既定のオプションとして選択します。
  • 有効: 既定のオプションとして新しい ADBC ドライバーを選択します。

この設定では、テナント内の各接続の種類の テスト 接続の動作も制御します。

ワークスペースのオーバーライド

テナント設定はワークスペースに委任されるため、ワークスペース管理者は、個々の接続を変更することなく、既定をオーバーライドして動作を比較できます。 この方法では、サイド バイ サイド検証が可能になります。 たとえば、1 つのワークスペースを使用して ADBC の既定値をテストし、別のワークスペースを ODBC の既定値に維持することができます。

実装の選択方法

接続で Implementation パラメーターを明示的に指定した場合、その値は常にテナントまたはワークスペースの既定値よりも優先されます。

次の表は、ドライバーの選択方法を示しています。

状態 使用されるドライバー
Implementation="2.0" ADBC
Implementation が指定されておらず、ワークスペースの設定が [オン] になっている ADBC
Implementation="1.0" ODBC
Implementation が指定されておらず、ワークスペースの設定が [オフ] になっている ODBC

オンプレミス データ ゲートウェイの動作

テナントとワークスペースの ADBC 設定は、 クラウド サービスで実行される更新パスに適用されます。 オンプレミス データ ゲートウェイを介してルーティングされるクエリでは、ゲートウェイのインストールにバンドルされているドライバーが引き続き使用されます。現在、この記事に記載されているコネクタの ODBC です。 テナントまたはワークスペースの設定が有効になっている場合、ゲートウェイ ルーティングの更新は ADBC に切り替わることはありません。これは想定される動作です。

移行を計画する際に注意すべき 2 つの結果:

  • ゲートウェイを使用して ADBC への移行をテストしている場合、ゲートウェイを介した更新には ADBC パスが反映されません。 クラウド接続を使用して ADBC をテストし、ADBC の動作をエンドツーエンドで正確に検証します。
  • ODBC 上に残る必要がある (たとえば、ゲートウェイ経由のプライベート リンク パスを保持する) お客様は、ODBC ドライバーがインストールされた状態でオンプレミス ゲートウェイ経由で更新をルーティングし続けることで、変更を延期できます。 これは永続的なオプトアウトではなく 遅延です。ODBC ドライバーが将来のゲートウェイ のインストールから削除されると ( キーの日付を参照)、以前のリリースにピン留めされたゲートウェイは最終的にサポートされなくなります。 それに応じて、ゲートウェイのアップグレードと ADBC 検証を計画します。
  1. pq-adbc-advisor を使用してワークスペースを監査 し、レガシ ドライバーをピン留めするすべての接続のインベントリを作成し、項目ごとのリスク分類を確認します。 pq-adbc-advisor を使用したワークスペースの監査を参照してください。
  2. パイロット ワークスペースを選択し、最初にワークスペースオーバーライドを使用して ADBC を有効にして、主要なデータセットを検証し、シナリオを更新します。 ADBC パスをエンドツーエンドで検証するには、 クラウド接続 を使用してテストします。ゲートウェイ ルーティング更新が ODBC に残る理由については、 オンプレミスデータ ゲートウェイの動作 に関するページを参照してください。
  3. Power BI Desktop で検証します。 現在の Power BI Desktop リリースをインストールします。このリリースには、既定のフリップに合格したすべてのスコープ内コネクタの ADBC ドライバーが付属しています。 既存のクエリに対して ADBC を強制するファイルごとの切り替えはありません。既存のクエリを ADBC にルーティングし、クエリを削除し、ソースを再追加して、フィールドを再選択します。 行数、列の種類、更新期間を ODBC ベースラインに対して更新および比較します。
  4. すぐに検証する重要な接続については、 Implementation="2.0"との接続ごとにオプトインします。
  5. 検証が完了したら、テナント レベルで既定で ADBC を有効にするかどうかを決定します。

pq-adbc-advisor を使用してワークスペースを監査する

移行する前に、変更する内容を把握しておく必要があります。 pq-adbc-advisorは、ワークスペースをスキャンして項目別の影響レポートを返す読み取り専用のFabricノートブックで、どのセマンティック モデル、データフロー、データ パイプラインが従来のODBCドライバーに引き続き固定されているかと、それぞれに対して取るべき対応を示します。

Note

この診断は、最終的な監査ではなく、開始点の診断です。 影響レポートは、作業の大部分を見つけるための最初のパスとして扱います。 コネクタの対応範囲は拡大しており、標準コネクタではまだ適切に対応できないコーナーケースがあります。 このツールは、これらのケースに明示的にフラグを設定し、チームがそれらをルーティングするメールボックスを示します。 価値の高い運用レポートの場合は、運用環境を反転する前に、アイテムのコピー内の ADBC パスを検証します。

影響レポートで提供される内容

影響レポートには、次の情報が表示されます。

  • ADBC に移行するコネクタ間でワークスペース内のすべての移行コネクタ呼び出しのインベントリ。

  • 各項目の切り替えリスク分類:

    リスク リスクの意味 何をすべきか
    失敗します M クエリは Implementation="1.0" にピン留めされており、この項目にはゲートウェイ バインドがありません。 カットオーバー時に、この更新は動作を停止します。 ソース ステップから [Implementation="1.0"] を削除するか、カットオーバーする前に項目をゲートウェイにバインドします。
    レビューが必要 M クエリが ODBC に固定されている一方でゲートウェイにバインドされている場合があり(cutover 後も動作しますが、やはり切り替える必要があります)、または M が、ADBC ではそのまま解釈されない生の DSN 文字列を組み立てている場合があります。 アイテムのコピー内の ADBC パスをテストし、ロールアウトします。DSN 文字列の場合、標準コネクタでは対応していません。アクセラレータに記載されているエスカレーション メールボックスにエスカレートします。
    Ready M クエリは既に ADBC (Implementation="2.0") をピン留めしているか、ピン留めされておらず、テナント スイッチによってきれいに処理されます。 アクションなし。 カットオーバー後に再スキャンして確認します。
  • セマンティック モデルだけでなく、Data Pipelines と Dataflow Gen2 にも対応。

  • 複数回のスキャンにまたがる解消状況の追跡 - 各スキャンには、初回実行時のベースラインと現在実行時のカウンターの両方が保持されるため、再スキャンを行うと、初回パス以降に何が解消されたかを確認できます。

影響レポートで行われないこと

影響レポートには次の内容はありません。

  • M 式を書き換える。
  • トリガーはそれ自体で更新されます (検証用に別のオプトイン エントリ ポイントが提供されます)。
  • M コード、項目名、エンドポイント URL、資格情報、または更新エラー メッセージの本文をワークスペースの外部に送信しないでください。

すべてのスキャンで匿名カウントがPower Query チームに送信されるため、導入を測定し、コネクタのカバレッジに優先順位を付けることができます。 スキャンでは、SHA-256 ハッシュテナントとユーザー識別子のみが送信され、既定では未加工の値は送信されません。 いつでもオプトアウトするには、アクセラレータに記載されているようにテレメトリを無効にします。 オプトアウトは、カーネルの再起動後も保持されます。

影響レポートを実行する方法

ツールを使用する最も簡単な方法は、Microsoft Fabric ツールボックスのスターター ノートブックを使用することです。

  1. スターター ノートブックをダウンロードし、Fabric ワークスペースにインポートします。
  2. インベントリするワークスペースにノートブックをアタッチします。
  3. ノートブックを上から下に実行します。 セッションに pq-adbc-advisor がインストールされ、ワークスペースがスキャンされ、影響レポートがインラインでレンダリングされ、レポートの HTML コピーが既定の lakehouse に保存されます (アタッチする場合)。
  4. 修正してください。
  5. ノートブックを再実行します。 このレポートには、解像度の差分 (最初のスキャン以降にクリーンアップしたピンの数) が表示されます。

管理者権限があり、テナント内のすべてのワークスペースをスキャンしたい場合、アクセラレータでは、Fabric 管理者 Scanner API を使用するテナント全体のスキャン オプションについて説明しています。 テナント スキャンは、通常、中規模のテナントに対して 15 ~ 30 分かかります。

バグ、機能要求、コネクタカバレッジのギャップについては、 アクセラレータ リポジトリを参照してください。

主な日付

  • 2026 年 7 月 (予定): テナント設定の広範なロールアウトが開始されます。 ワークスペースの動作は、この設定を継承し、サポートされているワークスペース管理者によってオーバーライドできます。
  • 2026 年 10 月 (予定):Microsoftロールアウトの準備状況に応じて、既定で段階的にテナント設定の有効化を開始する予定です。
  • 2027 年第 1 四半期 (予定):Microsoftロールアウトの準備状況に応じて、サービスからの ODBC ドライバーの削除を開始する予定です。 ODBC を維持する必要がある場合 (Implementation="1.0" またはワークスペースの設定 オフ)、ゲートウェイを使用して ODBC でクエリを実行し続ける必要があります。
  • Spring 2027 (計画済み):この記事で参照されている ODBC ドライバーは、Power BI Desktop またはゲートウェイに付属しなくなった予定です。

実施マイルストーンの前に、Microsoft顧客が移行と検証のアクティビティを完了できるように、事前通知を提供する予定です。

よく寄せられる質問

ADBC を今すぐテストできますか?

Yes. 現在の Power BI Desktop をインストールし、スコープ内のソースを再追加します。新しいクエリはすぐに ADBC にルーティングされます。 サービス側のテストでは、ワークスペースのオーバーライドを使用してパイロット ワークスペースで ADBC を有効にし、クラウド接続を介して検証します。

レガシ ODBC ドライバーをまだ使用しているすべての場所を検索するにはどうすればよいですか?

ワークスペースに対して pq-adbc-advisor を実行します。 これは、レガシ ドライバーを引き続き使用するすべてのセマンティック モデル、データフロー、およびデータ パイプラインをインベントリする読み取り専用のFabric ノートブックです。 各項目をカットオーバーリスクごとに分類し、何を変更すべきかを示します。 最終的な監査ではなく、開始点の診断として扱います。 pq-adbc-advisor を使用したワークスペースの監査を参照してください。 管理者は、Fabric管理者スキャナー API を使用してテナント全体のスイープを実行できます。 詳細については、アクセラレータのドキュメントを参照してください。

オンプレミス データ ゲートウェイを既に使用している場合、影響を受けますか?

テナントとワークスペースの ADBC 設定は、サービス内の実行にのみ適用されます。オンプレミス データ ゲートウェイ経由でルーティングされる更新には影響しません。 この記事で扱うコネクタでは、ゲートウェイ経由の更新処理で、カットオーバーまでは引き続き ODBC が使用されます。 オンプレミス データ ゲートウェイの動作を参照してください。 ODBC ドライバーは、今後のゲートウェイのインストールでは廃止される予定です。時期については、主な日程をご確認ください。

ADBC の移行をオプトアウトするにはどうすればよいですか?

完全にオプトアウトすることはできません。テナント設定を使用すると、検証期間中に既定のフリップを延期できますが、サービスで ODBC が無効になると、変更はユニバーサルになります。 サービス側のカットオーバー後も ODBC を引き続き使用するには、ODBC ドライバーがインストールされたオンプレミス データ ゲートウェイ経由で更新をルーティングする必要があります。 この変更は遅延のみであり、ODBC ドライバーは今後のゲートウェイ インストールから削除される予定です。

ワークスペースの ADBC 設定で Power BI Desktop ファイルが変更されないのはなぜですか?

Power BI Desktop では、ADBC のファイルごとの切り替えはありません。 Desktop ファイル内の既存のクエリは、クエリを再作成するまで、作成時に使用したドライバーのままになります。 既存のクエリの ADBC を検証するには、クエリを削除し、ソースを再追加して、フィールドを再選択します。 現在のデスクトップ リリースの新しいクエリは、既定のフリップを渡したコネクタに対して ADBC に自動的にルーティングされます。

ワークスペース ADBC 設定で既存の M クエリが書き換えられていますか?

No. テナントとワークスペースの設定によって、クエリの実行時に選択されるドライバーは変更されますが、M 式自体は変更されません。ホスト名、ポート、接続パラメーター、および M 内のコネクタ引数は、作成されたとおりに維持されます。 この動作は、新しく作成された接続と既存の接続の両方に適用されます。M で明示的に Implementation をピン留めしない接続は、反転した時点でワークスペース/テナントの既定値に従います。

ドライバーを M にピン留めする接続は、ワークスペース/テナントの既定値よりも優先されます。 Implementation="1.0"との接続は ODBC にとどまり、Implementation="2.0"はワークスペースまたはテナントの設定に関係なく ADBC にとどまります。 これらのいずれかを変更するには、M を編集します。

コネクタ固有の動作 (ODBC ドライバーと ADBC ドライバーの間のポートやオプションの違いを含む) については、「 コネクタとドライバーの変更 」の表にリンクされているコネクタ固有のドキュメントを参照してください。