Apps Script dapat terhubung ke database eksternal melalui layanan JDBC, yang merupakan wrapper seputar teknologi Konektivitas Database Java standar. Layanan JDBC mendukung Google Cloud SQL untuk database MySQL, MySQL, Microsoft SQL Server, dan Oracle.
Untuk memperbarui database eksternal menggunakan JDBC, skrip Anda harus membuka koneksi ke database, lalu membuat perubahan dengan mengirimkan pernyataan SQL.
Database Google Cloud SQL
Dengan Google Cloud SQL, Anda dapat membuat database relasional yang ada di cloud Google. Perhatikan bahwa Cloud SQL mungkin dikenai biaya berdasarkan penggunaan Anda.
Anda dapat membuat instance Google Cloud SQL dengan mengikuti langkah-langkah yang tercantum pada panduan memulai Cloud SQL.
Membuat koneksi Google Cloud SQL
Ada dua cara untuk membuat koneksi dengan database Google Cloud SQL menggunakan layanan JDBC Apps Script:
- (Direkomendasikan) Menghubungkan menggunakan Jdbc.getCloudSqlConnection(url)
- Menghubungkan menggunakan Jdbc.getConnection(url)
Metode ini dijelaskan di bawah. Keduanya valid, tetapi metode kedua mengharuskan Anda mengizinkan sekumpulan rentang IP untuk mengakses database Anda.
Menggunakan Jdbc.getCloudSqlConnection(url) (direkomendasikan)
Metode ini membuat koneksi ke instance MySQL di Google Cloud SQL menggunakan metode Jdbc.getCloudSqlConnection(url). URL database memiliki bentuk jdbc:google:mysql://subname
, dengan subname
yang merupakan Nama koneksi instance MySQL yang tercantum pada halaman Ringkasan instance Cloud SQL di Konsol Google Cloud.
Untuk terhubung ke Cloud SQL SQL Server, lihat Jdbc.getConnection(url).
Menggunakan Jdbc.getConnection(url)
Untuk menggunakan metode ini, Anda harus mengizinkan rentang alamat IP Classless Inter-Domain Routing (CIDR) tertentu agar server Apps Script dapat terhubung ke database Anda. Sebelum menjalankan skrip, selesaikan langkah-langkah berikut:
Dalam instance Google Cloud SQL, otorisasi rentang IP, satu per satu dari sumber data ini.
Salin URL yang ditetapkan ke database Anda; URL tersebut harus memiliki format
jdbc:mysql:subname
.
Setelah memberikan otorisasi untuk rentang IP ini, Anda dapat membuat koneksi ke instance Google Cloud SQL menggunakan salah satu metode Jdbc.getConnection(url) dan URL yang Anda salin di atas.
{i>Database<i} lainnya
Jika sudah memiliki database MySQL, Microsoft SQL Server, atau Oracle sendiri, Anda dapat menghubungkannya melalui layanan JDBC Apps Script.
Membuat koneksi database lain
Untuk membuat koneksi database menggunakan layanan JDBC Apps Script, dalam setelan database, Anda harus mengizinkan rentang IP dari sumber data ini.
Setelah daftar yang diizinkan ini diterapkan, Anda dapat membuat koneksi ke database menggunakan salah satu metode Jdbc.getConnection(url) dan URL database Anda.
Kode contoh
Kode contoh di bawah ini mengasumsikan bahwa Anda terhubung ke database Google Cloud SQL, dan membuat koneksi database menggunakan metode Jdbc.getCloudSqlConnection(url). Untuk database lain, Anda harus menggunakan metode Jdbc.getConnection(url) untuk membuat koneksi database.
Untuk mengetahui informasi selengkapnya tentang metode JDBC, lihat dokumentasi Java untuk JDBC.
Membuat {i>database<i}, pengguna, dan tabel
Sebagian besar developer menggunakan
alat command line MySQL untuk
membuat database, pengguna, dan tabel. Namun, Anda dapat melakukan hal yang sama
di Apps Script, seperti yang ditunjukkan di bawah ini. Sebaiknya buat setidaknya satu pengguna lain sehingga skrip Anda tidak selalu harus terhubung ke database sebagai root
.
Menulis ke database
Contoh di bawah menunjukkan cara menulis satu data ke database serta batch yang berisi 500 data. Pengelompokan sangat penting untuk operasi massal.
Perhatikan juga penggunaan pernyataan berparameter, dengan variabel ditunjukkan oleh ?
. Untuk mencegah serangan injeksi SQL, Anda harus menggunakan pernyataan berparameter untuk menghindari semua data yang disediakan pengguna.
Membaca dari database
Contoh ini menunjukkan cara membaca data dalam jumlah besar dari database, dengan melakukan loop pada hasil yang ditetapkan sesuai kebutuhan.
Menutup koneksi
Koneksi JDBC ditutup secara otomatis saat skrip selesai dieksekusi. (Perlu diingat bahwa satu panggilan google.script.run
dihitung sebagai eksekusi lengkap, meskipun halaman layanan HTML yang melakukan panggilan tetap terbuka.)
Meskipun demikian, jika Anda sudah selesai dengan koneksi, pernyataan, atau kumpulan hasil
sebelum akhir skrip, sebaiknya tutup secara manual dengan memanggil
JdbcConnection.close()
,
JdbcStatement.close()
,
atau
JdbcResultSet.close()
.
Menampilkan dialog pemberitahuan atau perintah juga akan menghentikan semua koneksi JDBC yang terbuka. Namun, elemen lain yang menampilkan elemen UI, seperti menu atau dialog kustom, dan sidebar dengan konten kustom, tidak menampilkannya.
Google, Google Workspace, serta merek dan logo terkait adalah merek dagang Google LLC. Semua nama perusahaan dan produk lainnya adalah merek dagang masing-masing perusahaan yang bersangkutan.