비고
Databricks JDBC 드라이버 소스 코드 는 Apache 2.0 라이선스에서 공개적으로 사용할 수 있습니다.
이는 투명성, 공동 작업 및 커뮤니티 기반 개발의 힘에 대한 Databricks의 노력을 반영합니다. 개발자, 사용자 및 커뮤니티의 기여를 환영합니다. 시작하려면 기여 지침을 참조하세요.
Databricks JDBC 드라이버를 사용하면 데이터베이스 관리 시스템에 액세스하기 위한 업계 표준 사양인 JDBC(Java Database Connectivity)를 통해 DataGrip, DBeaver 및 SQL Workbench/J 와 같은 도구를 Azure Databricks에 연결할 수 있습니다.
이 드라이버는 JDBC API를 구현했으며 OAuth, Cloud Fetch 및 Unity 카탈로그 볼륨 수집과 같은 기능을 비롯한 핵심 기능을 제공합니다. 네이티브 쿼리 모드를 실행하고 네이티브 매개 변수가 있는 쿼리를 지원하며, 유익한 쿼리 결과 보존 기능 또는 Thrift를 제공하는 문 실행 API를 사용하여 실행할 수 있습니다.
비고
IBM AIX 운영 체제에서는 Apache 화살표 결과 형식이 지원되지 않습니다. Cloud Fetch는 화살표에 의존하므로 Cloud Fetch는 AIX에서도 지원되지 않습니다. SQL 실행 중에 오류를 방지하려면 JDBC 연결 속성을 설정하여 화살표를 사용하지 않도록 설정합니다. EnableArrow=0
이 문서에서는 Databricks JDBC 드라이버 버전 3 이상을 설치하고 사용하는 방법에 대한 정보를 제공합니다. 버전 3 아래의 Databricks JDBC Driver(Simba)에 대한 자세한 내용은 Databricks JDBC Driver(Simba)를 참조하세요.
요구 사항
Databricks JDBC 드라이버를 사용하려면 다음 요구 사항을 충족해야 합니다.
- Java Runtime Environment(JRE) 11.0 이상. CI 테스트는 JRE 11, 17 및 21에서 지원됩니다.
전용 JDK 8 분기는 Java 8과의 호환성이 필요한 사용자가 사용할 수 있습니다. 사용자는 필요에 따라 이 분기에서 JAR을 빌드할 수 있습니다. 이 분기는 주기적으로 주 분기와 동기화되지만, 이를 계속 업데이트하기 위해 커뮤니티의 기여가 환영됩니다. Databricks JDBC 드라이버 JDK 8 분기를 참조하세요.
비고
JDBC 드라이버에서 사용하는 Apache Arrow 라이브러리와의 호환성 문제를 발생시킨 JDK 16의 변경으로 인해 JDBC 드라이버를 JDK 16 이상에서 사용할 때 런타임 오류가 발생할 수 있습니다. 이러한 오류를 방지하려면 다음 JVM 명령 옵션을 사용하여 애플리케이션 또는 드라이버를 다시 시작합니다.
--add-opens=java.base/java.nio=org.apache.arrow.memory.core ALL-UNNAMED
드라이버 설치
Databricks JDBC 드라이버는 Maven 리포지토리에 게시됩니다.
드라이버를 설치하려면 다음 중 원하는 작업을 수행할 수 있습니다.
Maven 프로젝트의 경우 프로젝트
pom.xml파일에 다음 종속성을 추가하여 Maven에 지정된 버전으로 JDBC 드라이버를 자동으로 다운로드하도록 지시합니다.<dependency> <groupId>com.databricks</groupId> <artifactId>databricks-jdbc</artifactId> <version>3.0.5</version> <scope>runtime</scope> </dependency>Gradle 프로젝트의 경우 프로젝트의 빌드 파일에 다음 종속성을 추가하여 지정된 버전으로 JDBC 드라이버를 자동으로 다운로드하도록 Gradle에 지시합니다.
implementation 'com.databricks:databricks-jdbc:3.0.5'
다른 프로젝트 형식에 대한 종속성 구문을 보고 Databricks JDBC 드라이버의 최신 버전 번호를 얻으려면 Maven 리포지토리를 참조하세요.
다음 단계
- 연결 URL 구성
- 인증 및 프록시 구성 속성
- SQL 구성 속성
- SSL 트러스트 저장소 구성
- 로깅 활성화
- 볼륨에서 파일 관리
- 예: JDBC 드라이버를 사용하여 쿼리 실행
- Databricks JDBC 드라이버를 사용하여 메트릭 뷰 메타데이터 작업