Trino JDBC ドライバー

  • [アーティクル]

重要

現在、この機能はプレビュー段階にあります。 ベータ版、プレビュー版、または一般提供としてまだリリースされていない Azure の機能に適用されるその他の法律条項については、「Microsoft Azure プレビューの追加の使用条件」に記載されています。 この特定のプレビューについては、Azure HDInsight on AKS のプレビュー情報に関する記事をご覧ください。 質問や機能の提案については、詳細を記載した要求を AskHDInsight で送信してください。また、その他の更新情報については、Azure HDInsight コミュニティのフォローをお願いいたします。

HDInsight on AKS を使った Trino には、Microsoft Entra 認証をサポートする JDBC ドライバーが用意されています。このドライバーには、いくつかのパラメーターが追加されています。

インストール

JDBC ドライバー jar は、Trino CLI パッケージに含まれています。HDInsight on AKS の Trino CLI のインストール手順をご覧ください。 CLI が既にインストールされている場合は、次のパスでファイル システムで見つけることができます。

Windows: C:\Program Files (x86)\Microsoft SDKs\Azure\TrinoCli-<version>\lib

Linux: ~/lib/trino-cli

認証

Trino JDBC ドライバーは、Microsoft Entra 認証のさまざまな方法をサポートしています。 次の表は、重要なパラメータと認証方法について説明するものです。 詳細については、認証に関するページをご覧ください。

パラメーター 意味 必須 説明
auth 認証方法の名前 いいえ ユーザー資格情報を指定する方法を決定します。 指定していない場合は AzureDefault が使用されます。
azureClient サービス プリンシパル/アプリケーションのクライアント ID AzureClientSecret, AzureClientCertificate については、はい
azureTenant Microsoft Entra テナント ID AzureClientSecret, AzureClientCertificate については、はい
azureCertificatePath 証明書へのファイル パス AzureClientCertificate については、はい。 証明書の pfx/pem ファイルへのパス。
azureUseTokenCache トークン キャッシュを使用するかどうか いいえ 指定した場合、アクセス トークンはキャッシュされ、AzureDefault, AzureInteractive, AzureDeviceCode モードで再利用されます。
azureScope トークンのスコープ いいえ トークンを要求する Microsoft Entra スコープ文字列。
password サービス プリンシパルのクライアント シークレット 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 ドライバーの使用」セクションで確認できます。