Hibernate를 사용하여 Spanner Omni에 연결

미리보기

이 제품 또는 기능은 서비스별 약관의 일반 서비스 약관 섹션에 있는 "GA 이전 제공 서비스 약관"이 적용되는 미리보기 제공 서비스이며, 소프트웨어 프로그램을 개발, 테스트, 프로토타입 제작, 시연하는 목적으로만 사용할 수 있습니다. 데이터 처리 또는 상업적 목적으로는 사용할 수 없습니다. GA 이전 제품 및 기능은 '현재 상태 그대로' 제공되며 지원이 제한될 수 있습니다. 자세한 내용은 출시 단계 설명을 참조하세요.

Hibernate ORM은 자바 프로그래밍 언어를 위한 객체 관계형 매핑 (ORM) 도구입니다. 객체 지향 도메인 모델을 관계형 데이터베이스에 매핑하기 위한 프레임워크를 제공합니다. 오픈소스 Spanner 언어 (SpannerDialect)를 사용하여 GoogleSQL 언어 데이터베이스를 Hibernate와 통합할 수 있습니다.

이 문서에서는 Spanner Omni에 연결하도록 Hibernate를 구성하는 방법을 설명합니다. Hibernate는 Spanner와 통합되는 방식과 동일한 방식으로 Spanner Omni와 통합됩니다. Spanner는 Hibernate ORM 6.x와 호환됩니다. Spanner 언어는 표준 Hibernate 및 Java Persistence 주석을 사용하여 가장 일반적인 항목 유형과 관계에 사용되는 SQL, DML, DDL 문을 생성합니다.

Spanner Omni와 함께 Hibernate를 사용하면 기존 Hibernate 환경을 사용하여 데이터베이스와 상호작용할 수 있습니다. 자세한 내용은 Spanner 문서의 Hibernate ORM (Spanner 언어)과 Spanner 통합 을 참조하세요.

기본 요건

Spanner Omni와 함께 Hibernate를 사용하려면 프로젝트에 다음 Maven 종속 항목을 포함하세요.

• Spanner Hibernate 언어: pom.xml 파일에 다음을 추가합니다. 버전 4.2.1 이상을 사용합니다.

  <dependency>
    <groupId>com.google.cloud</groupId>
    <artifactId>google-cloud-spanner-hibernate-dialect</artifactId>
    <version>4.2.1</version>
  </dependency>
  

• Spanner JDBC 드라이버: pom.xml 파일에 다음을 추가합니다. 버전 2.35.0 이상을 사용합니다.

  <dependency>
    <groupId>com.google.cloud</groupId>
    <artifactId>google-cloud-spanner-jdbc</artifactId>
    <version>2.35.0</version>
  </dependency>
  

참고: Spanner Omni와 함께 Hibernate ORM에 대한 공식 지원은 오픈소스 Spanner JDBC 드라이버를 통해 제공됩니다.

Hibernate 구성

표준 Hibernate 언어 규칙을 사용하여 hibernate.properties 파일에서 SpannerDialect 및 Spanner 드라이버 클래스를 구성합니다.

hibernate.dialect=com.google.cloud.spanner.hibernate.SpannerDialect
hibernate.connection.driver_class=com.google.cloud.spanner.jdbc.JdbcDriver
hibernate.connection.url=jdbc:spanner://ENDPOINT/databases/DATABASE_ID?isExperimentalHost=true

Spanner Omni 인스턴스에서 사용하는 특정 연결 프로토콜(일반 텍스트, TLS 또는 mTLS)의 hibernate.connection.url을 업데이트합니다. 자세한 내용은 Spanner Omni 연결 설정을 참조하세요. 보안 모드의 경우 Java SDK TLS 안내에 설명된 대로 Java 트러스트 저장소에 CA 인증서를 추가하거나 애플리케이션을 실행할 때 직접 전달합니다.