注
このコネクタは Databricks によって所有および提供されています。
概要
| プロパティ | Value |
|---|---|
| コネクタ |
Azure Databricks |
| プロダクツ | Power BI (セマンティック モデル) Power Query Online |
| リリース状況 | 一般公開 |
| Category | Database |
| 認証の種類 | Azure Active Directory Databricks クライアント資格情報 個人用アクセス トークン |
| 製品固有の認証 | サービス プリンシパル (Power BI/Fabric) ワークスペース 識別情報 (Power BI / Fabric) |
| データソースの種類 | Databricks |
| 関数リファレンス ドキュメント | Databricks.CatalogsDatabricks.ContentsDatabricks.Query |
Important
Power BIのAzure Databricks コネクタで、Arrow Database Connectivity (ADBC) ドライバーがサポートされるようになりました。 このコネクタは、埋め込み Simba Spark ODBC ドライバーから Databricks ADBC ドライバーに移行しています。 移行ガイダンス、主要な日付、および管理コントロールについては、「Power BI および Fabric の odbc から ADBC ドライバーへの
Prerequisites
プライベート ネットワークの場合は、次のネットワーク設定を実装する必要があります。
-
*.blob.core.windows.net*と*.store.core.windows.netネットワーク環境で開く必要があります。 - この証明書のダウンロードと失効の一覧 も、許可リストに追加する必要があります。
- Databricks ワークスペース ストレージ アカウントでファイアウォールのサポートが有効になっている場合は、ストレージ アカウントへのプライベート アクセスを許可するように、仮想ネットワーク データ ゲートウェイまたはオンプレミス データ ゲートウェイを構成する必要があります。 これにより、Fabric Power BI サービスがワークスペース ストレージ アカウントに引き続きアクセスでき、CloudFetch が引き続き正常に機能します。 または、構成
EnableQueryResultDownload=0で CloudFetch を無効にすることもできます。
サポートされている機能
- 輸入
- DirectQuery (Power BI セマンティック モデル)
Parameters
エントリポイント:Databricks.Catalogs
必須パラメーター数: 2
| Parameter | 表示名 | Required | タイプ | Group | 説明 | サンプルの値 | ヌラブル |
|---|---|---|---|---|---|---|---|
| ホスティング | サーバーホスト名 | イエス | SMS 送信 | Databricks サーバーのホスト名。 | "example.azuredatabricks.net" | false | |
| httpPath | HTTP パス | イエス | SMS 送信 | クラスターの HTTP パス。 | "/sql/1.0/warehouses/abcdef1234567890" | false | |
| オプション | 詳細オプション | No | null 許容可能レコード | 詳細オプション | true |
options 内のフィールド
| フィールド | 表示名 | Required | タイプ | Group | 説明 | 宣言済みの既定値 | 許可される値 | サンプルの値 | ヌラブル | Optional | 許可される値のメタデータ | 定義された許可される値 |
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| options.Catalog | 既定のカタログ | No | SMS 送信 | 詳細オプション | 接続の既定カタログを選択してください。 | false | true | |||||
| オプション.データベース | Database | No | SMS 送信 | 詳細オプション | 選択したデータベースへの接続を制限します。 これにより、テーブルの一覧表示が高速化される可能性があります。ただし、複数の異なるデータベースにヒットするクエリでは、クエリ フォールディングが行われなくなります。 | false | true | |||||
| options.QueryTags | クエリ タグ | No | SMS 送信 | 詳細オプション | system.query.history テーブル内のクエリを追跡するためのキー値タグ。 | "tag1:value1,tag2:value2" | false | true | ||||
| options.EnableAutomaticProxyDiscovery | 自動プロキシ検出 | No | SMS 送信 | 詳細オプション | これにより、Windows システム全体の自動プロキシ検出が可能になります。 | "enabled" (有効);"disabled" (無効 (既定)) | false | true | [{"Metadata": {"Documentation.Caption": "Enabled", "Documentation.Name": "AutomaticProxyDiscoveryFlag.Enabled"}, "Value": "enabled"}, {"Metadata": {"Documentation.Caption": "Disabled (default)", "Documentation.Name": "AutomaticProxyDiscoveryFlag.Disabled"}, "Value": "disabled"}] | ["enabled", "disabled"] | ||
| options.Implementation | Implementation | No | SMS 送信 | 詳細オプション | '2.0 (ベータ) を使用して ADBC を指定します。 「既定値」を指定すると、環境構成を使用して、使用するドライバーを決定します。 | "2.0" | "2.0" (2.0 - ADBC);null (システムの既定値) | false | true | ["2.0", null] | ||
| options.Protocol | プロトコル | No | SMS 送信 | 詳細オプション | ADBC ドライバーで使用されるプロトコルを指定します。 ステートメント実行 API を使用するには、'REST (SEA)' を選択します。 設定しない場合は、ドライバーの既定値 (Thrift) が使用されます。 | null 値 | null (既定値);"rest" (REST (SEA)) | false | true | [null, "rest"] |
Power Query Desktop から接続する
AWS、Azure、または GCP
Power Query Desktop から Databricks に接続するには、次の手順を実行します。
データの取得エクスペリエンスで、Databricks を検索して、Databricks コネクタ (Azure Databricks を一覧に表示します。 Databricks 担当者から指示がない限り、すべての Databricks SQL Warehouse データに対して Azure Databricks コネクタを使用します。
Databricks SQL Warehouse の Server ホスト名 と HTTP パス を指定します。 「サーバー ホスト名」と「HTTP パス」を検索する手順については、「Databricks ODBC ドライバーと JDBC ドライバー を構成する」を参照してください。 必要に応じて、この情報を入力します。 必要に応じて、既定のカタログやデータベースを 詳細オプションで指定できます。 [OK] を選択して続行します。
Databricks SQL Warehouse で認証するための資格情報を指定します。 資格情報には、次の 3 つのオプションがあります。
Databricks クライアント資格情報。 Databricks OAuth M2M クライアント資格情報の生成手順については、Databricks OAuth M2M を参照してください。
個人用アクセス トークン (AWS、Azure、または GCP で使用できます)。 個人用アクセス トークン (PAT) を生成する手順については、「 個人用アクセス トークン」を参照してください。
Azure Active Directory (Azureでのみ使用できます)。 ブラウザー ポップアップを使用して組織アカウントにサインインします。
注
特定の Databricks SQL Warehouse の資格情報を入力すると、Power BI デスクトップは資格情報をキャッシュし、以降の接続試行で同じ資格情報を再利用します。 これらの資格情報を変更するには、[ファイル] > [オプションと設定] > [データ ソース設定] に移動します。 詳細情報: 認証方法を変更する
正常に接続されると、ナビゲーター に、クラスターで使用可能なデータが表示されます。 Transform Data を選択して、Power Query または Load を使用してデータを変換し、Power Query Desktop にデータを読み込むことができます。
Power Query Online から接続する
Power Query Online から Databricks に接続するには、次の手順を実行します。
データの取得エクスペリエンスで Azure Databricks オプションを選択します。 アプリによって、Power Query Online のデータ取得エクスペリエンスにアクセスする方法が異なります。 Power Query Online にアプリからデータを取得する方法の詳細については、「Where to get data」を参照してください。
検索ボックスを使用して、使用可能な Databricks コネクタの一覧を表示します。 Databricks 担当者から指示がない限り、すべての Databricks SQL Warehouse データに対して Azure Databricks コネクタを使用します。
Databricks SQL Warehouse の Server ホスト名 と HTTP パス を入力します。 「サーバー ホスト名」と「HTTP パス」を検索する手順については、「Databricks ODBC ドライバーと JDBC ドライバー を構成する」を参照してください。 必要に応じて、既定のカタログやデータベースを 詳細オプションで指定できます。
Azure Databricks の接続設定と資格情報のスクリーンショット Databricks SQL Warehouse で認証するための資格情報を指定します。 資格情報には、次の 4 つのオプションがあります。
- Databricks クライアント資格情報。 Databricks OAuth M2M クライアント資格情報の生成手順については、「 Databricks OAuth M2M」を参照してください。
- 個人用アクセス トークン (AWS、Azure、または GCP で使用できます)。 個人用アクセス トークン (PAT) の生成手順については、個人用アクセス トークン を参照してください。
- Azure Active Directory (Azureでのみ使用できます)。 ブラウザー ポップアップを使用して組織アカウントにサインインします。
- サービス プリンシパル (Azureでのみ使用できます)。 Microsoft Entra ID サービス プリンシパルを使用して認証します。 このオプションは、クラウドまたはゲートウェイ接続を構成するときに使用できます。
正常に接続されると、ナビゲーター が表示され、サーバーで使用可能なデータが表示されます。 ナビゲーターでデータを選択します。 次に、Next を選択して、Power Query内のデータを変換します。
追加情報
Arrow Database Connectivity ドライバー コネクタの実装
Power BIのAzure Databricks コネクタには、Arrow Database Connectivity (ADBC) ドライバーを使用できます。 引き続きこのコネクタに新しい機能を強化して追加するため、最新バージョンにアップグレードして試して 製品のフィードバックを送信することをお勧めします。
注
2026 年 2 月以降、Power BI Desktop または Power BI Service で作成された新しい接続では、 既定で Arrow Database Connectivity (ADBC) ドライバーが自動的に使用されます。 既存の接続では、 手動で ADBC に更新しない限り、ODBC が引き続き使用されます。
ADBC ドライバーに切り替えるには:
- Power BIで目的のダッシュボードを開きます。
- データの変革を選択します。
Query オプション セクションで を選択します。詳細エディター - ADBC の
Implementation="2.0"を指定します。let Source = Databricks.Catalogs("adb-<workspace-id>.<random-number>.azuredatabricks.net", "/sql/1.0/warehouses/<sql-warehouse-id>", [Catalog=null, Database=null, EnableAutomaticProxyDiscovery=null, Implementation="2.0"]), powerbi_Database = Source{[Name="powerbi",Kind="Database"]}[Data], default_Schema = powerbi_Database{[Name="default",Kind="Schema"]}[Data], dashboard_data_Table = default_Schema{[Name="dashboard_data",Kind="Table"]}[Data] in dashboard_data_Table
制限事項と考慮事項
- Azure Databricks コネクタは、web プロキシをサポートします。 ただし、.pac ファイルで定義されている自動プロキシ設定はサポートされていません。
- Azure Databricks コネクタでは、
Databricks.Queryデータ ソースは、Power BIセマンティック モデルの DirectQuery モードと組み合わせてサポートされていません。
Azure Databricks