Trino JDBC ドライバー
Note
Azure HDInsight on AKS は 2025 年 1 月 31 日に廃止されます。 2025 年 1 月 31 日より前に、ワークロードを Microsoft Fabric または同等の Azure 製品に移行することで、ワークロードの突然の終了を回避する必要があります。 サブスクリプション上に残っているクラスターは停止され、ホストから削除されることになります。
提供終了日までは基本サポートのみが利用できます。
重要
現在、この機能はプレビュー段階にあります。 ベータ版、プレビュー版、または一般提供としてまだリリースされていない Azure の機能に適用されるその他の法律条項については、「Microsoft Azure プレビューの追加の使用条件」に記載されています。 この特定のプレビューについては、「Microsoft 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>\libLinux:
~/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 ドライバーの使用」セクションで確認できます。