JDBC 드라이버

JDBC 드라이버 (JDBC driver)

Trino JDBC 드라이버는 Java 기반 애플리케이션과 JVM에서 실행되는 다른 비-Java 애플리케이션이 Trino에 접근할 수 있게 해 줘요. 리포팅과 데이터베이스 개발에 쓰이는 데스크톱·서버 측 애플리케이션 모두 JDBC 드라이버를 사용해요.

출처: 문서

본문

JDBC 드라이버는 HTTP/HTTPS를 통한 클라이언트 프로토콜로 클러스터의 코디네이터와 통신해요.

요구사항 (Requirements)

Trino JDBC 드라이버에는 다음 요구사항이 있어요:

  • Java 11 이상. 압축 해제 성능 향상을 위해 Java 22 이상을 권장해요.
  • JDBC 드라이버로 Trino에 연결하는 모든 사용자는 system.jdbc 스키마의 쿼리 테이블에 접근 권한이 있어야 해요.
  • Trino 클러스터의 코디네이터에 HTTP/HTTPS 네트워크 접근이 가능해야 해요.
  • 스풀링 프로토콜이 활성화되어 있다면, 구성된 오브젝트 스토리지에 네트워크 접근이 가능해야 해요.

JDBC 드라이버 버전은 Trino 클러스터 버전과 같거나 더 새로운 것이어야 해요. 이전 버전은 보통 동작하지만 일부 하위 집합만 정기적으로 테스트돼요. 350 이전 버전은 지원되지 않아요.

설치 (Installation)

trino-jdbc-483.jar을 다운로드해 Java 애플리케이션의 클래스패스에 추가하세요.

드라이버는 Maven Central에서도 사용할 수 있어요:

    io.trino
    trino-jdbc
    483

연결 (Connecting)

JDBC URL 형식은 다음과 같아요:

jdbc:trino://host:port
jdbc:trino://host:port/catalog
jdbc:trino://host:port/catalog/schema

예:

jdbc:trino://example.net:8080/hive/sales

Java 코드에서 Properties로 연결:

// properties
String url = "jdbc:trino://example.net:8080/hive/sales";
Properties properties = new Properties();
properties.setProperty("user", "test");
properties.setProperty("password", "secret");
properties.setProperty("SSL", "true");
Connection connection = DriverManager.getConnection(url, properties);

// URL parameters
String url = "jdbc:trino://example.net:8443/hive/sales?user=test&password=secret&SSL=true";
Connection connection = DriverManager.getConnection(url);

더 알아보기 (Learn more)

명령줄에서 Trino를 쓰는 방법이 궁금하다면 Trino CLI 문서를 이어서 읽어 보세요.