Trino JDBC 驅動程式
注意
AKS 上的 Azure HDInsight 將於 2025 年 1 月 31 日退場。 請於 2025 年 1 月 31 日之前，將工作負載移轉至 Microsoft Fabric 或對等的 Azure 產品，以免工作負載突然終止。 訂用帳戶中剩餘的叢集將會停止，並會從主機移除。
在淘汰日期之前，只有基本支援可用。
重要
此功能目前為預覽功能。 Microsoft Azure 預覽版增補使用規定包含適用於 Azure 功能 (搶鮮版 (Beta)、預覽版，或尚未正式發行的版本) 的更多法律條款。 若需此特定預覽版的相關資訊，請參閱 Azure HDInsight on AKS 預覽版資訊。 如有問題或功能建議，請在 AskHDInsight 上提交要求並附上詳細資料，並且在 Azure HDInsight 社群上追蹤我們以獲得更多更新資訊。
使用 AKS 上 HDInsight 的 Trino 提供 JDBC 驅動程式，其支援 Microsoft Entra 驗證，並為此驗證新增幾個參數。
安裝
JDBC 驅動程式 jar 包含在 Trino CLI 套件中，為 AKS 上的 HDInsight 安裝 Trino CLI。 如果已安裝 CLI，則可以在檔案系統上找到 CLI，路徑如下：
Windows：
C:\Program Files (x86)\Microsoft SDKs\Azure\TrinoCli-<version>\libLinux：
~/lib/trino-cli
驗證
Trino JDBC 驅動程式支援各種 Microsoft Entra 驗證方法。 下表描述重要的參數和驗證方法。 如需詳細資訊，請參閱驗證。
| 參數 | 意義 | 必要 | 描述 |
|---|---|---|---|
| auth | 驗證方法名稱 | No | 決定如何提供使用者認證。 如果未指定，請使用AzureDefault。 |
| azureClient | 服務主體/應用程式的用戶端識別碼 | 適用於 AzureClientSecret, AzureClientCertificate。 |
|
| azureTenant | Microsoft Entra 租用戶識別碼 | 適用於 AzureClientSecret, AzureClientCertificate。 |
|
| azureCertificatePath | 憑證的檔案路徑 | 適用於 AzureClientCertificate。 |
具有憑證的 pfx/pem 檔案路徑。 |
| azureUseTokenCache | 使用權杖快取與否 | No | 如果提供，則會在 AzureDefault, AzureInteractive, AzureDeviceCode 模式中快取並重複使用存取權杖。 |
| azureScope | 權杖範圍 | No | 用於請求權仗的 Microsoft Entra 範圍字串。 |
| password | 服務主體的用戶端密碼 | 適用於 AzureClientSecret。 |
使用 AzureClientSecret 模式時，服務主體的祕密/密碼。 |
| accessToken | JWT 存取權杖 | No | 如果從外部取得存取權杖，可以使用此參數來提供。 在此情況下，不允許 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 程式碼中使用 JDBC 驅動程式區段包含使用此驗證的範例 Java 程式碼。