Menggunakan Hibernate untuk terhubung ke Spanner Omni

Pratinjau

Produk atau fitur ini adalah penawaran pratinjau yang tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum di Persyaratan Khusus Layanan, dan hanya dapat digunakan untuk tujuan pengembangan, pengujian, pembuatan prototipe, dan demonstrasi program software. Alat ini tidak dapat digunakan untuk tujuan pemrosesan data atau komersial apa pun. Produk dan fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Hibernate ORM adalah alat pemetaan relasional objek (ORM) untuk bahasa pemrograman Java. Framework ini menyediakan kerangka kerja untuk memetakan model domain berorientasi objek ke database relasional. Anda dapat mengintegrasikan database dialek GoogleSQL dengan Hibernate menggunakan dialek Spanner open source (SpannerDialect).

Dokumen ini menjelaskan cara mengonfigurasi Hibernate untuk terhubung ke Spanner Omni. Hibernate terintegrasi dengan Spanner Omni dengan cara yang sama seperti saat terintegrasi dengan Spanner. Spanner kompatibel dengan Hibernate ORM 6.x. Dialek Spanner menghasilkan pernyataan SQL, DML, dan DDL untuk sebagian besar jenis dan hubungan entitas umum menggunakan anotasi Hibernate dan Java Persistence standar.

Dengan menggunakan Hibernate dengan Spanner Omni, Anda dapat menggunakan pengalaman Hibernate yang ada untuk berinteraksi dengan database Anda. Untuk mengetahui informasi selengkapnya, lihat Mengintegrasikan Spanner dengan Hibernate ORM (dialek Spanner) dalam dokumentasi Spanner.

Prasyarat

Untuk menggunakan Hibernate dengan Spanner Omni, sertakan dependensi Maven berikut dalam project Anda:

• Dialek Hibernate Spanner: Tambahkan kode berikut ke file pom.xml Anda. Gunakan versi 4.2.1 atau yang lebih baru.

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

• Driver JDBC Spanner: Tambahkan kode berikut ke file pom.xml Anda. Gunakan versi 2.35.0 atau yang lebih baru.

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

Catatan: Dukungan formal untuk Hibernate ORM dengan Spanner Omni diberikan melalui driver JDBC Spanner open source.

Mengonfigurasi Hibernasi

Konfigurasi class driver SpannerDialect dan Spanner di file hibernate.properties menggunakan konvensi dialek Hibernate standar:

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

Perbarui hibernate.connection.url untuk protokol koneksi tertentu (plain-text, TLS, atau mTLS) yang digunakan instance Spanner Omni Anda. Untuk mengetahui informasi selengkapnya, lihat Membuat koneksi Spanner Omni. Untuk mode aman, tambahkan sertifikat CA ke truststore Java atau teruskan secara langsung saat Anda menjalankan aplikasi, seperti yang dijelaskan dalam petunjuk TLS Java SDK.