Trino JDBC ドライバー
大事な
AKS 上の Azure HDInsight は、2025 年 1 月 31 日に廃止されました。 これに関するお知らせ でについて詳しく学んでください。
ワークロードの突然の終了を回避するには、ワークロードを Microsoft Fabric または同等の Azure 製品 に移行する必要があります。
大事な
この機能は現在プレビュー段階です。 Microsoft Azure プレビューの 追加使用条件 には、ベータ版、プレビュー版、または一般公開されていない Azure 機能に適用される、より多くの法的条件が含まれています。 この特定のプレビューの詳細については、AKS プレビュー情報 Azure HDInsightを参照してください。 ご質問や機能の提案については、AskHDInsight に詳細を記載した要求を送信し、より多くの情報を得るために Azure HDInsight Community をフォローしてください。
AKS 上の HDInsight を使用した Trino には、Microsoft Entra 認証をサポートする JDBC ドライバーが用意されています。このドライバーには、いくつかのパラメーターが追加されています。
取り付ける
JDBC ドライバー jar は Trino CLI パッケージに含まれています。AKSに HDInsight 用 Trino CLI をインストールします。 CLI が既にインストールされている場合は、次のパスでファイル システムで見つけることができます。
Windows:
C:\Program Files (x86)\Microsoft SDKs\Azure\TrinoCli-<version>\libLinux:
~/lib/trino-cli
認証
Trino JDBC ドライバーは、Microsoft Entra 認証のさまざまな方法をサポートしています。 次の表では、重要なパラメーターと認証方法について説明します。 詳細については、認証を参照してください。
| パラメーター | 意味 | 必須 | 説明 |
|---|---|---|---|
| 認証 | 認証方法の名前 | いいえ | ユーザー資格情報を指定する方法を決定します。 指定しない場合は、AzureDefaultを使用します。 |
| azureClient | サービス プリンシパル/アプリケーションのクライアント ID |
AzureClientSecret, AzureClientCertificateはい。 |
|
| azureTenant | Microsoft Entra テナント ID | はい、AzureClientSecret, AzureClientCertificate。 |
|
| Azure証明書パス | 証明書へのファイル パス |
AzureClientCertificateに賛成です。 |
証明書を含む pfx/pem ファイルへのパス。 |
| azureUseTokenCache | トークン キャッシュを使用するかどうか | いいえ | 指定した場合、アクセス トークンはキャッシュされ、AzureDefault, AzureInteractive, AzureDeviceCode モードで再利用されます。 |
| azureScope | トークン スコープ | いいえ | トークンを要求するための Microsoft Entra スコープ文字列。 |
| パスワード | サービス プリンシパルのクライアント シークレット |
AzureClientSecretはい。 |
AzureClientSecret モードを使用する場合のサービス プリンシパルのシークレット/パスワード。 |
| accessToken | JWT アクセス トークン | いいえ | 外部から取得したアクセス トークンの場合は、このパラメーターを使用して指定できます。 この場合、auth パラメーターは使用できません。 |
例 - 接続文字列
| 説明 | JDBC 接続文字列 |
|---|---|
| AzureDefault | jdbc:trino://cluster1.pool1.region1.projecthilo.net |
| 対話型ブラウザー認証 | jdbc:trino://cluster1.pool1.region1.projecthilo.net?auth=AzureInteractive |
| トークン キャッシュを使用する | jdbc:trino://cluster1.pool1.region1.projecthilo.net?auth=AzureInteractive&azureUseTokenCache=true |
| シークレット付きサービス プリンシパル | jdbc:trino://cluster1.pool1.region1.projecthilo.net?auth=AzureClientSecret&azureTenant=11111111-1111-1111-1111-111111111111&azureClient=11111111-1111-1111-1111-111111111111&password=placeholder |
Java コードでの JDBC ドライバーの使用
JDBC jar ファイルを見つけて、ローカル maven リポジトリにインストールします。
mvn install:install-file -Dfile=<trino-jdbc-*.jar> -DgroupId=io.trino -DartifactId=trino-jdbc -Dversion=<trino-jdbc-version> -Dpackaging=jar -DgeneratePom=true
JDBC 使用して Trino に接続するサンプル Java コードをダウンロードしてアンパックします。 詳細と例については、含まれている README.md を参照してください。
オープン ソースの Trino JDBC ドライバーの使用
また、外部からアクセス トークンを取得し、オープン ソースの Trino JDBC ドライバーに渡すこともできます。この認証を使用した Java コードのサンプルは、java コード セクション の JDBC ドライバーを使用するに含まれています。