Impala データベース

概要

プロパティ Value
コネクタ Impala
プロダクツ Power BI (セマンティック モデル)
Power Query Online
リリース状況 一般公開
Category データベース
認証の種類 アノニマス
データベース
ウィンドウズ
データソースの種類 Impala
関数リファレンス ドキュメント Impala.Database

手記

一部の機能は 1 つの製品に存在する可能性がありますが、展開スケジュールとホスト固有の機能のため、他の製品には存在しない場合があります。

Important

このコネクタは、埋め込み Simba Impala ODBC ドライバーから HiveServer2 ADBC ドライバーに移行しています。 移行ガイダンス、主要な日付、および管理コントロールについては、「Power BI および Fabric の odbc から ADBC ドライバーへの変換」を参照してください。

手記

Impala コネクタ実装 2.0 は、2025 年 7 月からプレビュー段階です。

サポートされている機能

  • 輸入
  • DirectQuery (Power BI セマンティック モデル)
  • 詳細オプション
    • 接続タイムアウト時間
    • コマンド のタイムアウト期間

Parameters

エントリポイント:Impala.Database

必須パラメーター数: 1

Impala クラスターからデータをインポートする

Impala クラスター serverからデータをインポートします。 ポートが指定されていない場合は、既定のポート 21050 が使用されます。

Parameter 表示名 Required タイプ Group サンプルの値 ヌラブル
サーバー Server Yes SMS 送信 "hostname:port" false
オプション 詳細オプション いいえ null 許容可能レコード 詳細オプション true

options内のフィールド

フィールド 表示名 Required タイプ Group 宣言済みの既定値 サンプルの値 ヌラブル Optional
options.Implementation いいえ SMS 送信 詳細オプション "2.0" "1.0"; "2.0" false true
options.ConnectionTimeout 接続タイムアウト時間 いいえ NULL許容の期間 詳細オプション {"Kind": "literal", "Text": "00:01:02"} true true
options.CommandTimeout コマンド のタイムアウト期間 いいえ NULL許容の期間 詳細オプション {"Kind": "literal", "Text": "01:02:03"} true true

Power Query Desktop から接続する

Impala データベースに接続するには、次の手順を実行します。

  1. Power BI Desktop の [ホーム] リボンで [データの取得] を選択します。

  2. カテゴリの一覧から [データベース ] を選択し、[ Impala] を選択し、[ 接続] を選択します。

    [データベース] カテゴリと [Impala コネクタ] が選択されている [データの取得] ダイアログのスクリーンショット。

  3. 表示された Impala ウィンドウで、Impala サーバーの名前を入力するか、ボックスに貼り付けます。 Power BI にデータを直接インポートしたり、DirectQuery を使用したりできます。 DirectQueryを使用した の詳細について説明します。 次に、[OK]を選択します。

    [サーバー名] が入力され、[データ接続のインポート] モードが選択されている Impala ダイアログのスクリーンショット。

  4. メッセージが表示されたら、資格情報を入力するか、匿名で接続します。 Impala コネクタは、匿名、データベース (ユーザー名とパスワード)、および Windows 認証をサポートします。

    [匿名]、[Windows]、[データベース] が選択され、[データベース] が選択されている認証ダイアログのスクリーンショット。

    認証方法の詳細については、「データ ソースを使用した認証」を参照してください。

    手記

    接続が暗号化されていない場合は、次のメッセージが表示されます。 暗号化されていない接続 使用する場合は、[OK] を選択します。

    暗号化サポート ダイアログのスクリーンショット。接続を確立できないことを強調し、暗号化されていない接続を使用するかどうかを確認します。

  5. 接続すると、ナビゲーター ウィンドウが表示され、サーバーで使用可能なデータが表示されます。 データを読み込む を選択するか、データの変換 を選択し、Power Query エディターでデータの変換を続行します。

    既定のデータベースと顧客データが選択され、顧客データが表示されているナビゲーターのスクリーンショット。

Power Query Online から接続する

Impala データベースに接続するには、次の手順を実行します。

  1. コネクタの選択で Impala オプションを選択します。

  2. [ データ ソースへの接続] で、必要に応じてサーバーの名前とポート番号を指定します。

    Impala データベースのオンライン接続を入力する [データ ソースへの接続] ダイアログのスクリーンショット。

  3. 必要に応じて、オンプレミス データ ゲートウェイの名前を選択します。

  4. この Impala データベースに初めて接続する場合は、[ 認証の種類] で接続の資格情報の種類を選択します。

  5. 資格情報を入力します。

  6. 暗号化された接続 使用する場合は [暗号化された接続 を使用する] を選択するか、暗号化されていない接続を使用する場合はオプションをオフにします。

  7. [次 を選択して続行します。

  8. ナビゲーターで必要なデータを選択し、[データの変換] を選択して、Power Query エディターでデータを変換します。

追加情報

詳細オプション

Power Query には、必要に応じてクエリに追加できる一連の高度なオプションが用意されています。 次の表に、Power Query で設定できるすべての詳細オプションを示します。

詳細オプション 説明
接続タイムアウト時間 Power Query が接続の完了を待機する最大時間を指定します。 接続を長く開いたままにしておくために、別の値を入力できます。
コマンド のタイムアウト期間 Power Query が呼び出しを中止するまでのコマンドの実行が許可される最大時間を指定します。

コネクタの実装 2.0

2025 年 8 月に、Impala コネクタの新しい実装を導入し、Impala との統合を強化しました。 最新の機能を利用するには、Power BI Desktop とオンプレミス データ ゲートウェイを最新バージョンにアップグレードすることをお勧めします。

引き続きコネクタの改善に役立つ フィードバック をお寄せください。

Impala コネクタ実装 2.0 は、オープンソースの Arrow Database Connectivity (ADBC) ドライバーを使用して構築されています。 ADBC には、方向データを操作するための一連の標準インターフェイスが用意されています。これは、オーバーヘッドを最小限に抑え、シリアル化やコピーなしで大規模なデータセットをフェッチする場合に特に効率的です。 ADBC ドライバーには、メモリの安全性やガベージ コレクションなどのセキュリティ強化も組み込まれています。

さらに、オープンソース コミュニティとのコラボレーションにより、最新のツールとセキュリティで保護された開発ライフサイクル (SDL) プロセスを利用して、より迅速な更新が可能になります。 これらのパフォーマンスとセキュリティの強化を利用できるように、新しく作成されたすべての接続では、2025 年 8 月以降に 2.0 実装が自動的に使用されます。 移行期間中は、既存のクエリを更新し、Implementation="2.0" に フラグを追加することで、2.0 の実装をテストできます。 移行後、実装を指定しない接続は自動的に 2.0 実装に更新されます。

Source = Impala.Database("impalavm.centralus.cloudapp.azure.com", [Implementation="2.0"])

潜在的な問題の診断を支援するために、次の例のように、Mashup ログで Implementation と DriverType の詳細を見つけることができます。 移行中に問題が発生した場合は、サポートにお問い合わせください。

{ 
    "Start": "2024-11-02T00:14:02.7968686Z", 
    "Action": "Engine/Module/Impala/IO/Impala/Implementation", 
    "ResourceKind": "Impala", 
    "ResourcePath": "impalavm.centralus.cloudapp.azure.com",
    "HostProcessId": "29200",
    "Implementation": "2.0",
    "DriverType": "ADBC",
    "ProductVersion": "2.139.0.0 (Main)+eda56ecd858054173a4d11db9c63a6da5cf92a99",
    "ActivityId": "106f16b6-cfbb-4853-9f20-ed45486486d2",
    "Process": "Microsoft.Mashup.Container.NetFX45",
    "Pid": 38560,
    "Tid": 1,
    "Duration": "00:00:00.0000291"
}

(トラブルシューティング中に) 前のコネクタの実装を一時的に維持するには、クエリで Implementation="1.0" を指定します。

制限事項と考慮事項

Impala コネクタに留意すべき考慮事項と制限事項を次に示します。

  • Impala コネクタは、サポートされている 3 つの認証メカニズムのいずれかを使用して、オンプレミス データ ゲートウェイでサポートされています。
  • Impala コネクタは Impala ドライバーを使用します。このドライバーでは、文字列型のサイズが既定で 32 K に制限されます。
  • Impala コネクタでは、Kerberos 認証の 領域 オプションのオーバーライドはサポートされていません。
  • 最終更新: