Tujuan
Tutorial ini akan memandu Anda melalui langkah-langkah berikut menggunakan driver JDBC Spanner:
- Buat instance dan database Spanner.
- Menulis, membaca, dan menjalankan kueri SQL pada data di database.
- Perbarui skema database.
- Perbarui data menggunakan transaksi baca-tulis.
- Tambahkan indeks sekunder ke database.
- Gunakan indeks untuk membaca dan menjalankan kueri SQL pada data.
- Mengambil data menggunakan transaksi hanya baca.
Biaya
Tutorial ini menggunakan Spanner, yang merupakan komponenGoogle Cloudyang dapat ditagih. Untuk mengetahui informasi tentang biaya penggunaan Spanner, lihat Harga.
Sebelum memulai
Selesaikan langkah-langkah yang dijelaskan dalam Menyiapkan, yang mencakup pembuatan dan penetapan project Google Cloud default, pengaktifan penagihan, pengaktifan Cloud Spanner API, dan penyiapan OAuth 2.0 untuk mendapatkan kredensial autentikasi guna menggunakan Cloud Spanner API.
Khususnya, pastikan Anda menjalankan gcloud auth
application-default login
untuk menyiapkan lingkungan pengembangan lokal dengan kredensial
autentikasi.
Menyiapkan lingkungan JDBC lokal Anda
Instal komponen berikut di mesin pengembangan Anda jika belum diinstal:
Clone repositori aplikasi contoh ke komputer lokal Anda:
git clone https://github.com/googleapis/java-spanner-jdbc.git
Ubah ke direktori yang berisi kode contoh Spanner:
cd java-spanner-jdbc/samples/snippets
Membuat instance
Saat pertama kali menggunakan Spanner, Anda harus membuat instance, yang merupakan alokasi resource yang digunakan oleh database Spanner. Saat membuat instance, Anda memilih konfigurasi instance, yang menentukan tempat penyimpanan data Anda, dan juga jumlah node yang akan digunakan, yang menentukan jumlah resource penayangan dan penyimpanan di instance Anda.
Jalankan perintah berikut untuk membuat instance Spanner di region
us-central1
dengan 1 node:
gcloud spanner instances create test-instance --config=regional-us-central1 \
--description="Test Instance" --nodes=1
Perhatikan bahwa perintah ini membuat instance dengan karakteristik berikut:
- ID Instance
test-instance
- Nama tampilan
Test Instance
- Konfigurasi instance
regional-us-central1
(Konfigurasi regional menyimpan data di satu region, sementara konfigurasi multi-region mendistribusikan data di beberapa region. Untuk mengetahui informasi selengkapnya, lihat Tentang instance.) - Jumlah node 1 (
node_count
sesuai dengan jumlah resource serving dan penyimpanan yang tersedia untuk database di instance. Pelajari lebih lanjut di Node dan unit pemrosesan.)
Anda akan melihat:
Creating instance...done.
Melihat-lihat file contoh
Repositori contoh berisi contoh yang menunjukkan cara menggunakan Spanner dengan JDBC.
pom.xml
menambahkan driver JDBC Spanner ke dependensi project dan mengonfigurasi plugin assembly untuk membuat file JAR yang dapat dieksekusi dengan class Java yang ditentukan dalam tutorial ini.
Bangun contoh dari
direktori samples/snippets
:
mvn package -DskipTests
Buat database
GoogleSQL
java -jar target/jdbc-snippets/jdbc-samples.jar \
createdatabase test-instance example-db
PostgreSQL
java -jar target/jdbc-snippets/jdbc-samples.jar \
createpgdatabase test-instance example-db
Anda akan melihat:
Created database [projects/my-project/instances/test-instance/databases/example-db]
GoogleSQL
PostgreSQL
Langkah selanjutnya adalah menulis data ke database Anda.
Membuat koneksi JDBC
Sebelum dapat melakukan operasi baca atau tulis, Anda harus membuatConnection
. Semua interaksi Anda dengan Spanner harus melalui Connection
. Nama database dan properti lainnya ditentukan dalam URL koneksi JDBC dan set java.util.Properties
.
GoogleSQL
PostgreSQL
Untuk mengetahui daftar lengkap properti yang didukung, lihat Properti URL Koneksi.
Setiap Connection
menggunakan resource, jadi sebaiknya tutup
koneksi saat tidak lagi diperlukan, atau gunakan kumpulan koneksi untuk
menggunakan kembali koneksi di seluruh aplikasi Anda.
Baca selengkapnya di referensi Javadoc Connection
.
Menghubungkan driver JDBC ke emulator
Anda dapat menghubungkan driver JDBC ke emulator Spanner dengan dua cara:
- Tetapkan variabel lingkungan
SPANNER_EMULATOR_HOST
: Hal ini menginstruksikan driver JDBC untuk terhubung ke emulator. Instance dan database Spanner di URL koneksi JDBC harus sudah ada di emulator. - Tambahkan
autoConfigEmulator=true
ke URL koneksi: Tindakan ini akan menginstruksikan driver JDBC untuk terhubung ke emulator, dan membuat instance serta database Spanner secara otomatis di URL koneksi JDBC jika instance dan database tersebut belum ada.
Contoh ini menunjukkan cara menggunakan opsi URL koneksi autoConfigEmulator=true
.
GoogleSQL
PostgreSQL
Menulis data dengan DML
Anda dapat menyisipkan data menggunakan Bahasa Pengolahan Data (DML) dalam transaksi baca-tulis.
Anda menggunakan metode PreparedStatement.executeUpdate()
untuk mengeksekusi pernyataan DML.
GoogleSQL
PostgreSQL
Jalankan sampel dengan perintah ini:
GoogleSQL
java -jar target/jdbc-snippets/jdbc-samples.jar \
writeusingdml test-instance example-db
PostgreSQL
java -jar target/jdbc-snippets/jdbc-samples.jar \
writeusingdmlpg test-instance example-db
Anda akan melihat:
4 records inserted.
Menulis data dengan batch DML
Anda menggunakan metodePreparedStatement#addBatch()
dan
PreparedStatement#executeBatch()
untuk menjalankan beberapa pernyataan DML dalam
satu batch.
GoogleSQL
PostgreSQL
Jalankan sampel dengan perintah ini:
GoogleSQL
java -jar target/jdbc-snippets/jdbc-samples.jar \
writeusingdmlbatch test-instance example-db
PostgreSQL
java -jar target/jdbc-snippets/jdbc-samples.jar \
writeusingdmlbatchpg test-instance example-db
Anda akan melihat:
3 records inserted.
Menulis data dengan mutasi
Anda juga dapat menyisipkan data menggunakan mutasi.
Anda dapat menulis data menggunakan
objek Mutation
.
Objek Mutation
adalah penampung untuk operasi mutasi. Mutation
mewakili urutan penyisipan, pembaruan, dan penghapusan yang diterapkan Spanner
secara atomik ke baris dan tabel yang berbeda dalam database Spanner.
Metode newInsertBuilder()
di class Mutation
membuat mutasi INSERT
, yang menyisipkan
baris baru dalam tabel. Jika baris sudah ada, penulisan akan gagal. Atau,
Anda dapat menggunakan metode newInsertOrUpdateBuilder
untuk membuat mutasi INSERT_OR_UPDATE
, yang memperbarui nilai kolom
jika baris sudah ada.
write()
di antarmuka CloudSpannerJdbcConnection
menulis mutasi. Semua
mutasi dalam satu batch diterapkan secara atomik.
Anda dapat membuka antarmuka CloudSpannerJdbcConnection
dari Connection
JDBC Spanner.
Kode ini menunjukkan cara menulis data menggunakan mutasi:
GoogleSQL
PostgreSQL
Jalankan sampel dengan perintah ini:
GoogleSQL
java -jar target/jdbc-snippets/jdbc-samples.jar \
write test-instance example-db
PostgreSQL
java -jar target/jdbc-snippets/jdbc-samples.jar \
writepg test-instance example-db
Anda akan melihat:
Inserted 10 rows.
Membuat kueri data menggunakan SQL
Spanner mendukung antarmuka SQL untuk membaca data, yang dapat Anda akses di command line menggunakan Google Cloud CLI atau secara terprogram menggunakan driver JDBC Spanner.
Di command line
Jalankan pernyataan SQL berikut untuk membaca nilai semua kolom dari tabel
Albums
:
GoogleSQL
gcloud spanner databases execute-sql example-db --instance=test-instance \
--sql='SELECT SingerId, AlbumId, AlbumTitle FROM Albums'
PostgreSQL
gcloud spanner databases execute-sql example-db --instance=test-instance \
--sql='SELECT singer_id, album_id, album_title FROM albums'
Hasilnya menampilkan:
SingerId AlbumId AlbumTitle
1 1 Total Junk
1 2 Go, Go, Go
2 1 Green
2 2 Forever Hold Your Peace
2 3 Terrified
Menggunakan driver JDBC Spanner
Selain menjalankan pernyataan SQL di command line, Anda dapat mengeluarkan pernyataan SQL yang sama secara terprogram menggunakan driver JDBC Spanner.
Metode dan class berikut digunakan untuk menjalankan kueri SQL:- Metode
createStatement()
di antarmukaConnection
: gunakan ini untuk membuat objek pernyataan baru untuk menjalankan pernyataan SQL. - Metode
executeQuery(String)
dari classStatement
: gunakan metode ini untuk menjalankan kueri terhadap database. - Class
Statement
: gunakan class ini untuk mengeksekusi string SQL. - Class
ResultSet
: gunakan class ini untuk mengakses data yang ditampilkan oleh pernyataan SQL.
Berikut cara mengeluarkan kueri dan mengakses data:
GoogleSQL
PostgreSQL
Jalankan sampel dengan perintah ini:
GoogleSQL
java -jar target/jdbc-snippets/jdbc-samples.jar \
query test-instance example-db
PostgreSQL
java -jar target/jdbc-snippets/jdbc-samples.jar \
querypg test-instance example-db
Anda akan melihat hasil berikut:
1 1 Total Junk
1 2 Go, Go, Go
2 1 Green
2 2 Forever Hold Your Peace
2 3 Terrified
Membuat kueri menggunakan parameter SQL
Jika aplikasi Anda memiliki kueri yang sering dijalankan, Anda dapat meningkatkan performanya dengan memparameterisasinya. Kueri parametrik yang dihasilkan dapat di-cache dan digunakan kembali, yang mengurangi biaya kompilasi. Untuk mengetahui informasi selengkapnya, lihat Menggunakan parameter kueri untuk mempercepat kueri yang sering dijalankan.
Berikut adalah contoh penggunaan parameter dalam klausa WHERE
untuk
mengkueri data yang berisi nilai tertentu untuk LastName
.
Gunakan java.sql.PreparedStatement
untuk menjalankan kueri dengan parameter.
GoogleSQL
PostgreSQL
Jalankan sampel dengan perintah ini:
GoogleSQL
java -jar target/jdbc-snippets/jdbc-samples.jar \
querywithparameter test-instance example-db
PostgreSQL
java -jar target/jdbc-snippets/jdbc-samples.jar \
querywithparameterpg test-instance example-db
Anda akan melihat hasil berikut:
12 Melissa Garcia
Memperbarui skema database
Misalkan Anda perlu menambahkan kolom baru bernama MarketingBudget
ke tabel Albums
. Menambahkan kolom baru ke tabel yang sudah ada memerlukan pembaruan pada
skema database Anda. Spanner mendukung update skema ke database saat
database terus melayani traffic. Pembaruan skema tidak memerlukan database
offline dan tidak mengunci seluruh tabel atau kolom; Anda dapat terus
menulis data ke database selama pembaruan skema. Baca selengkapnya tentang pembaruan skema yang didukung dan performa perubahan skema di Melakukan pembaruan skema.
Menambahkan kolom
Anda dapat menambahkan kolom di command line menggunakan Google Cloud CLI atau secara terprogram menggunakan driver JDBC Spanner.
Di command line
Gunakan perintah ALTER TABLE
berikut untuk menambahkan kolom baru ke tabel:
GoogleSQL
gcloud spanner databases ddl update example-db --instance=test-instance \
--ddl='ALTER TABLE Albums ADD COLUMN MarketingBudget INT64'
PostgreSQL
gcloud spanner databases ddl update example-db --instance=test-instance \
--ddl='ALTER TABLE albums ADD COLUMN marketing_budget BIGINT'
Anda akan melihat:
Schema updating...done.
Menggunakan driver JDBC Spanner
Gunakan metodeexecute(String)
dari class java.sql.Statement
untuk mengubah skema:
GoogleSQL
PostgreSQL
Jalankan sampel dengan perintah ini:
GoogleSQL
java -jar target/jdbc-snippets/jdbc-samples.jar \
addmarketingbudget test-instance example-db
PostgreSQL
java -jar target/jdbc-snippets/jdbc-samples.jar \
addmarketingbudgetpg test-instance example-db
Anda akan melihat:
Added MarketingBudget column.
Menjalankan batch DDL
Sebaiknya jalankan beberapa modifikasi skema dalam satu batch. Gunakan metode
addBatch(String)
java.sql.Statement
untuk menambahkan beberapa pernyataan DDL ke batch.
GoogleSQL
PostgreSQL
Jalankan sampel dengan perintah ini:
GoogleSQL
java -jar target/jdbc-snippets/jdbc-samples.jar \
ddlbatch test-instance example-db
PostgreSQL
java -jar target/jdbc-snippets/jdbc-samples.jar \
ddlbatchpg test-instance example-db
Anda akan melihat:
Added Venues and Concerts tables.
Menulis data ke kolom baru
Kode berikut menulis data ke kolom baru. Tindakan ini menetapkan MarketingBudget
ke
100000
untuk baris yang dikunci oleh Albums(1, 1)
dan ke 500000
untuk baris yang dikunci
oleh Albums(2, 2)
.
GoogleSQL
PostgreSQL
Jalankan sampel dengan perintah ini:
GoogleSQL
java -jar target/jdbc-snippets/jdbc-samples.jar \
update test-instance example-db
PostgreSQL
java -jar target/jdbc-snippets/jdbc-samples.jar \
updatepg test-instance example-db
Anda akan melihat output yang serupa dengan ini:
Updated albums
Anda juga dapat menjalankan kueri SQL atau panggilan baca untuk mengambil nilai yang baru saja Anda tulis.
Berikut kode untuk menjalankan kueri:
GoogleSQL
PostgreSQL
Untuk menjalankan kueri ini, jalankan perintah berikut:
GoogleSQL
java -jar target/jdbc-snippets/jdbc-samples.jar \
querymarketingbudget test-instance example-db
PostgreSQL
java -jar target/jdbc-snippets/jdbc-samples.jar \
querymarketingbudgetpg test-instance example-db
Hasilnya menampilkan:
1 1 100000
1 2 null
2 1 null
2 2 500000
2 3 null
Memperbarui data
Anda dapat memperbarui data menggunakan DML dalam transaksi baca-tulis.
Tetapkan AutoCommit=false
untuk menjalankan transaksi baca-tulis di JDBC.
GoogleSQL
PostgreSQL
Jalankan sampel dengan perintah ini:
GoogleSQL
java -jar target/jdbc-snippets/jdbc-samples.jar \
writewithtransactionusingdml test-instance example-db
PostgreSQL
java -jar target/jdbc-snippets/jdbc-samples.jar \
writewithtransactionusingdmlpg test-instance example-db
Tag transaksi dan tag permintaan
Gunakan tag transaksi dan tag permintaan
untuk memecahkan masalah transaksi dan kueri di Spanner. Anda dapat menetapkan tag transaksi dan tag permintaan di JDBC dengan variabel sesi TRANSACTION_TAG
dan STATEMENT_TAG
.
GoogleSQL
PostgreSQL
Jalankan sampel dengan perintah ini:
GoogleSQL
java -jar target/jdbc-snippets/jdbc-samples.jar \
tags test-instance example-db
PostgreSQL
java -jar target/jdbc-snippets/jdbc-samples.jar \
tagspg test-instance example-db
Mengambil data menggunakan transaksi hanya baca
Misalkan Anda ingin menjalankan lebih dari satu pembacaan pada stempel waktu yang sama. Transaksi hanya baca mengamati awalan
yang konsisten dari histori commit transaksi, sehingga aplikasi Anda selalu mendapatkan
data yang konsisten.
Tetapkan ReadOnly=true
dan AutoCommit=false
pada java.sql.Connection
, atau gunakan
pernyataan SQL SET TRANSACTION READ ONLY
, untuk mengeksekusi transaksi
hanya baca.
Berikut cara menjalankan kueri dan melakukan pembacaan dalam transaksi hanya baca yang sama:
GoogleSQL
PostgreSQL
Jalankan sampel dengan perintah ini:
GoogleSQL
java -jar target/jdbc-snippets/jdbc-samples.jar \
readonlytransaction test-instance example-db
PostgreSQL
java -jar target/jdbc-snippets/jdbc-samples.jar \
readonlytransactionpg test-instance example-db
Anda akan melihat output yang mirip dengan:
1 1 Total Junk
1 2 Go, Go, Go
2 1 Green
2 2 Forever Hold Your Peace
2 3 Terrified
2 2 Forever Hold Your Peace
1 2 Go, Go, Go
2 1 Green
2 3 Terrified
1 1 Total Junk
Kueri yang dipartisi dan Data Boost
partitionQuery
API membagi kueri menjadi bagian-bagian yang lebih kecil, atau partisi, dan menggunakan beberapa
mesin untuk mengambil partisi secara paralel. Setiap partisi diidentifikasi dengan
token partisi. PartitionQuery API memiliki latensi yang lebih tinggi daripada API kueri standar, karena hanya ditujukan untuk operasi massal seperti mengekspor atau memindai seluruh database.
Data Boost memungkinkan Anda menjalankan kueri analisis dan ekspor data dengan dampak yang hampir tidak ada terhadap workload yang ada di instance Spanner yang disediakan. Peningkatan Data hanya mendukung kueri yang dipartisi.
GoogleSQL
PostgreSQL
Jalankan sampel dengan perintah ini:
GoogleSQL
java -jar target/jdbc-snippets/jdbc-samples.jar \
databoost test-instance example-db
PostgreSQL
java -jar target/jdbc-snippets/jdbc-samples.jar \
databoostpg test-instance example-db
Untuk mengetahui informasi selengkapnya tentang cara menjalankan kueri berpartisi dan menggunakan Data Boost dengan driver JDBC, lihat:
- GoogleSQL: Pernyataan kueri yang dipartisi dan Data Boost
- PostgreSQL: Data Boost dan pernyataan kueri yang dipartisi
DML yang dipartisi
Bahasa Pengolahan Data (DML) Terpartisi dirancang untuk jenis update dan penghapusan massal berikut:
- Pembersihan berkala dan pembersihan sampah memori.
- Mengisi ulang kolom baru dengan nilai default.
PostgreSQL
Jalankan sampel dengan perintah ini:
GoogleSQL
java -jar target/jdbc-snippets/jdbc-samples.jar \
pdml test-instance example-db
PostgreSQL
java -jar target/jdbc-snippets/jdbc-samples.jar \
pdmlpg test-instance example-db
Untuk mengetahui informasi selengkapnya tentang AUTOCOMMIT_DML_MODE
, lihat:
Pembersihan
Agar tidak menimbulkan biaya tambahan pada akun Penagihan Cloud Anda untuk resource yang digunakan dalam tutorial ini, hapus database dan hapus instance yang Anda buat.
Menghapus database
Jika Anda menghapus instance, semua database di dalamnya akan otomatis dihapus. Langkah ini menunjukkan cara menghapus database tanpa menghapus instance (Anda tetap dikenai biaya untuk instance tersebut).
Di command line
gcloud spanner databases delete example-db --instance=test-instance
Menggunakan Google Cloud console
Buka halaman Spanner Instances di konsol Google Cloud .
Klik instance.
Klik database yang ingin Anda hapus.
Di halaman Database details, klik Delete.
Konfirmasi bahwa Anda ingin menghapus database, lalu klik Hapus.
Menghapus instance
Menghapus instance akan otomatis menghapus semua database yang dibuat di instance tersebut.
Di command line
gcloud spanner instances delete test-instance
Menggunakan Google Cloud console
Buka halaman Spanner Instances di konsol Google Cloud .
Klik instance Anda.
Klik Hapus.
Konfirmasi bahwa Anda ingin menghapus instance, lalu klik Hapus.
Langkah berikutnya
- Pelajari cara Mengintegrasikan Spanner dengan Spring Data JPA (dialek GoogleSQL).
- Pelajari caraMengintegrasikan Spanner dengan Spring Data JPA (dialek PostgreSQL).
- Pelajari cara Mengintegrasikan Spanner dengan Hibernate ORM (dialek GoogleSQL).
- Pelajari caraMengintegrasikan Spanner dengan Hibernate ORM (dialek PostgreSQL).
- Pelajari lebih lanjut perintah pengelolaan sesi JDBC (GoogleSQL).
- Pelajari lebih lanjut perintah pengelolaan sesi JDBC (PostgreSQL).
Pelajari cara mengakses Spanner dengan instance virtual machine.
Pelajari kredensial otorisasi dan autentikasi di Mengautentikasi ke layanan Cloud menggunakan library klien.
Pelajari lebih lanjut Praktik terbaik desain skema Spanner.