다음을 통해 공유

Trino JDBC 드라이버

  • 아티클

참고 항목

2025년 1월 31일에 Azure HDInsight on AKS가 사용 중지됩니다. 2025년 1월 31일 이전에 워크로드가 갑자기 종료되지 않도록 워크로드를 Microsoft Fabric 또는 동등한 Azure 제품으로 마이그레이션해야 합니다. 구독의 나머지 클러스터는 호스트에서 중지되고 제거됩니다.

사용 중지 날짜까지 기본 지원만 사용할 수 있습니다.

Important

이 기능은 현지 미리 보기로 제공됩니다. Microsoft Azure 미리 보기에 대한 보충 사용 약관에는 베타 또는 미리 보기로 제공되거나 아직 일반 공급으로 릴리스되지 않은 Azure 기능에 적용되는 더 많은 약관이 포함되어 있습니다. 이 특정 미리 보기에 대한 자세한 내용은 Azure HDInsight on AKS 미리 보기 정보를 참조하세요. 질문이나 기능 제안이 있는 경우 AskHDInsight에서 세부 정보와 함께 요청을 제출하고 Azure HDInsight 커뮤니티에서 더 많은 업데이트를 확인하세요.

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>\lib

Linux: ~/lib/trino-cli

인증

Trino JDBC 드라이버는 다양한 Microsoft Entra 인증 방법을 지원합니다. 다음 표에서는 중요한 매개 변수 및 인증 방법을 설명합니다. 자세한 내용은 인증을 참조하세요.

매개 변수 의미 Required 설명
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 드라이버 사용에 포함되어 있습니다.