Protokol keamanan TLS versi 1.0 dan 1.1 dinonaktifkan. Untuk membuat koneksi, gunakan TLS 1.2 atau yang lebih baru.
Google Apps Script dapat terhubung ke database eksternal melalui layanan JDBC, yaitu sebuah wrapper untuk teknologi Java Database Connectivity standar. Layanan JDBC mendukung database Google Cloud SQL untuk MySQL, MySQL, Microsoft SQL Server, Oracle, dan PostgreSQL.
Jika spreadsheet Anda semakin besar atau Anda mengalami masalah waktu tunggu dengan perhitungan yang kompleks, memindahkan data ke database eksternal dapat meningkatkan performa dan keandalan secara signifikan.
Untuk memperbarui database eksternal dengan JDBC, skrip Anda harus membuka koneksi ke database, lalu membuat perubahan dengan mengirimkan pernyataan SQL.
Database Google Cloud SQL
Google Cloud SQL memungkinkan Anda membuat database relasional yang berada di cloud Google. Cloud SQL mungkin dikenai biaya berdasarkan penggunaan Anda.
Buat instance Google Cloud SQL dengan mengikuti langkah-langkah yang tercantum dalam 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
- Menghubungkan menggunakan Jdbc.getConnection
Keduanya valid, tetapi metode kedua mengharuskan Anda mengotorisasi serangkaian rentang IP untuk mengakses database Anda.
Menggunakan Jdbc.getCloudSqlConnection (direkomendasikan)
Metode ini membuat koneksi ke instance MySQL Google Cloud SQL menggunakan metode
Jdbc.getCloudSqlConnection. URL database memiliki format jdbc:google:mysql://subname, dengan
subname adalah Nama Koneksi Instance MySQL yang tercantum di halaman Ringkasan instance Cloud SQL
di Konsol Google Cloud.
Untuk terhubung ke Cloud SQL SQL Server, lihat Jdbc.getConnection.
Menggunakan Jdbc.getConnection
Agar dapat menggunakan metode ini, Anda harus mengotorisasi rentang alamat IP Classless Inter-Domain Routing (CIDR) tertentu sehingga server Apps Script dapat terhubung ke database Anda. Sebelum menjalankan skrip, selesaikan langkah-langkah berikut:
Di instance Google Cloud SQL Anda, otorisasi rentang IP, satu per satu dari sumber data ini.
Salin URL yang ditetapkan ke database Anda; URL tersebut harus dalam format
jdbc:mysql:subname.
Setelah mengotorisasi rentang IP ini, buat koneksi ke instance Google Cloud SQL Anda menggunakan salah satu metode Jdbc.getConnection dan URL yang Anda salin sebelumnya.
Database lainnya
Jika Anda sudah memiliki database MySQL, Microsoft SQL Server, Oracle, atau PostgreSQL sendiri, hubungkan ke database tersebut melalui layanan JDBC Apps Script.
Membuat koneksi database lainnya
Untuk membuat koneksi database menggunakan layanan JDBC Apps Script , Anda harus mengotorisasi rentang IP dari sumber data ini di setelan database Anda.
Layanan JDBC hanya dapat terhubung ke port 1025 atau yang lebih baru. Pastikan database Anda tidak menggunakan port yang lebih rendah.
Setelah daftar yang diizinkan ini ada, buat koneksi ke database menggunakan salah satu Jdbc.getConnection metode dan URL database Anda.
Kode contoh
Kode contoh berikut mengasumsikan bahwa Anda terhubung ke database Google Cloud SQL, dan membuat koneksi database menggunakan metode Jdbc.getCloudSqlConnection. Untuk database lainnya, Anda harus menggunakan metode Jdbc.getConnection untuk membuat koneksi database.
Untuk mengetahui informasi selengkapnya tentang metode JDBC, lihat dokumentasi Java untuk JDBC.
Membuat database, pengguna, dan tabel
Kebanyakan 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 dalam contoh berikut. 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 catatan ke database serta batch 500 catatan. Pengelompokan sangat penting untuk operasi massal.
Pernyataan berparameter digunakan, dengan variabel yang ditandai dengan ?. Untuk
mencegah serangan injeksi SQL,
gunakan pernyataan berparameter untuk meng-escape semua data yang diberikan pengguna.
Membaca dari database
Contoh ini menunjukkan cara membaca sejumlah besar data dari database, dengan melakukan loop pada set hasil sesuai kebutuhan.
Menutup koneksi
Koneksi JDBC akan otomatis ditutup saat skrip selesai dieksekusi. (Panggilan tunggal
google.script.run dihitung sebagai eksekusi lengkap, meskipun halaman layanan HTML yang melakukan panggilan tetap terbuka.)
Namun, jika Anda tahu bahwa Anda telah selesai menggunakan koneksi, pernyataan, atau set hasil
sebelum akhir skrip, tutup secara manual dengan memanggil
JdbcConnection.close,
JdbcStatement.close,
atau
JdbcResultSet.close.
Menampilkan dialog peringatan atau perintah juga akan menghentikan koneksi JDBC yang terbuka. Namun, elemen UI lain yang ditampilkan, seperti menu atau dialog kustom dan sidebar dengan konten kustom, tidak akan menghentikan koneksi JDBC.
Google, Google Workspace, serta merek dan logo terkait adalah merek dagang dari Google LLC. Semua nama perusahaan dan produk lainnya adalah merek dagang milik setiap perusahaan terkait.