JDBC

Apps Script dapat terhubung ke database eksternal melalui Layanan JDBC, wrapper di sekitar Teknologi Konektivitas Database Java. Layanan JDBC mendukung Google Cloud SQL untuk MySQL, MySQL, dan Microsoft SQL Server, dan database Oracle.

Untuk mengupdate database eksternal dengan JDBC, skrip Anda harus membuka koneksi ke {i>database<i} dan kemudian membuat perubahan dengan mengirim pernyataan SQL.

Database Google Cloud SQL

Google Cloud SQL memungkinkan Anda membuat database relasional yang aktif 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 dalam Panduan memulai Cloud SQL.

Membuat koneksi Google Cloud SQL

Ada dua cara untuk membuat koneksi dengan Google Cloud SQL menggunakan layanan JDBC Apps Script:

Metode ini dijelaskan di bawah. Keduanya valid, tetapi metode kedua mengharuskan Anda mengizinkan serangkaian rentang IP untuk mengakses database.

Metode ini membuat koneksi ke instance MySQL di Google Cloud SQL menggunakan alamat Jdbc.getCloudSqlConnection(url) . URL database memiliki bentuk jdbc:google:mysql://subname, dengan subname adalah Nama koneksi instance MySQL yang tercantum di halaman Overview instance Cloud SQL pada Konsol Google Cloud.

Untuk terhubung ke Cloud SQL Server, lihat Jdbc.getConnection(url).

Menggunakan Jdbc.getConnection(url)

Untuk menggunakan metode ini, Anda harus mengizinkan Classless Inter-Domain Routing (CIDR) Rentang alamat IP agar server Apps Script dapat terhubung ke database Anda. Sebelum menjalankan skrip, selesaikan langkah-langkah berikut:

  1. Dalam instance Google Cloud SQL Anda, mengotorisasi rentang IP, satu per satu dari sumber data ini.

  2. Salin URL yang ditetapkan ke database Anda; layar itu harus memiliki dari jdbc:mysql:subname.

Setelah Anda mengotorisasi rentang IP ini, Anda bisa membuat koneksi ke Instance Google Cloud SQL menggunakan salah satu Jdbc.getConnection(url) metode dan URL yang Anda salin di atas.

{i>Database<i} lain

Jika Anda sudah memiliki {i>database<i} MySQL, Microsoft SQL Server, atau Oracle Anda sendiri, Anda dapat menyambungkannya melalui layanan JDBC Apps Script.

Membuat koneksi database lainnya

Untuk membuat koneksi database menggunakan Apps Script Layanan JDBC, di setelan database Anda Anda harus mengizinkan rentang IP dari sumber data ini.

Setelah daftar yang diizinkan ini diterapkan, Anda dapat membuat koneksi ke database menggunakan salah satu Jdbc.getConnection(url) metode 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 Jdbc.getCloudSqlConnection(url) . Untuk {i>database<i} lain, Anda harus menggunakan Jdbc.getConnection(url) untuk membuat koneksi database.

Untuk 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 {i>database<i}, pengguna, dan tabel. Namun, mungkin saja dilakukan hal yang sama di Apps Script, seperti yang ditunjukkan di bawah ini. Sebaiknya, Anda membuat setidaknya satu pengguna lain sehingga skrip Anda tidak selalu harus terhubung ke {i>database<i} sebagai root.

service/jdbc.gs
/**
 * Create a new database within a Cloud SQL instance.
 */
function createDatabase() {
  try {
    const conn = Jdbc.getCloudSqlConnection(instanceUrl, root, rootPwd);
    conn.createStatement().execute('CREATE DATABASE ' + db);
  } catch (err) {
    // TODO(developer) - Handle exception from the API
    console.log('Failed with an error %s', err.message);
  }
}

/**
 * Create a new user for your database with full privileges.
 */
function createUser() {
  try {
    const conn = Jdbc.getCloudSqlConnection(dbUrl, root, rootPwd);

    const stmt = conn.prepareStatement('CREATE USER ? IDENTIFIED BY ?');
    stmt.setString(1, user);
    stmt.setString(2, userPwd);
    stmt.execute();

    conn.createStatement().execute('GRANT ALL ON `%`.* TO ' + user);
  } catch (err) {
    // TODO(developer) - Handle exception from the API
    console.log('Failed with an error %s', err.message);
  }
}

/**
 * Create a new table in the database.
 */
function createTable() {
  try {
    const conn = Jdbc.getCloudSqlConnection(dbUrl, user, userPwd);
    conn.createStatement().execute('CREATE TABLE entries ' +
      '(guestName VARCHAR(255), content VARCHAR(255), ' +
      'entryID INT NOT NULL AUTO_INCREMENT, PRIMARY KEY(entryID));');
  } catch (err) {
    // TODO(developer) - Handle exception from the API
    console.log('Failed with an error %s', err.message);
  }
}

Menulis ke database

Contoh di bawah ini menunjukkan cara menulis satu {i>record<i} ke {i>database<i} sebagai serta kumpulan 500 kumpulan data. Pengelompokan sangat penting untuk operasi massal.

Perhatikan juga penggunaan pernyataan berparameter, di mana variabelnya dilambangkan dengan ?. Untuk mencegah serangan injeksi SQL, Anda harus menggunakan pernyataan berparameter untuk meng-escape semua data yang disediakan pengguna.

service/jdbc.gs
/**
 * Write one row of data to a table.
 */
function writeOneRecord() {
  try {
    const conn = Jdbc.getCloudSqlConnection(dbUrl, user, userPwd);

    const stmt = conn.prepareStatement('INSERT INTO entries ' +
      '(guestName, content) values (?, ?)');
    stmt.setString(1, 'First Guest');
    stmt.setString(2, 'Hello, world');
    stmt.execute();
  } catch (err) {
    // TODO(developer) - Handle exception from the API
    console.log('Failed with an error %s', err.message);
  }
}

/**
 * Write 500 rows of data to a table in a single batch.
 */
function writeManyRecords() {
  try {
    const conn = Jdbc.getCloudSqlConnection(dbUrl, user, userPwd);
    conn.setAutoCommit(false);

    const start = new Date();
    const stmt = conn.prepareStatement('INSERT INTO entries ' +
      '(guestName, content) values (?, ?)');
    for (let i = 0; i < 500; i++) {
      stmt.setString(1, 'Name ' + i);
      stmt.setString(2, 'Hello, world ' + i);
      stmt.addBatch();
    }

    const batch = stmt.executeBatch();
    conn.commit();
    conn.close();

    const end = new Date();
    console.log('Time elapsed: %sms for %s rows.', end - start, batch.length);
  } catch (err) {
    // TODO(developer) - Handle exception from the API
    console.log('Failed with an error %s', err.message);
  }
}

Membaca dari database

Contoh ini menunjukkan cara membaca data dalam jumlah besar dari {i>database<i}, melakukan loop pada hasil yang telah diatur.

service/jdbc.gs
/**
 * Read up to 1000 rows of data from the table and log them.
 */
function readFromTable() {
  try {
    const conn = Jdbc.getCloudSqlConnection(dbUrl, user, userPwd);
    const start = new Date();
    const stmt = conn.createStatement();
    stmt.setMaxRows(1000);
    const results = stmt.executeQuery('SELECT * FROM entries');
    const numCols = results.getMetaData().getColumnCount();

    while (results.next()) {
      let rowString = '';
      for (let col = 0; col < numCols; col++) {
        rowString += results.getString(col + 1) + '\t';
      }
      console.log(rowString);
    }

    results.close();
    stmt.close();

    const end = new Date();
    console.log('Time elapsed: %sms', end - start);
  } catch (err) {
    // TODO(developer) - Handle exception from the API
    console.log('Failed with an error %s', err.message);
  }
}

Memutus koneksi

Koneksi JDBC menutup secara otomatis ketika skrip selesai dieksekusi. (Tetap masukkan Perlu diingat bahwa satu google.script.run dihitung sebagai eksekusi lengkap, bahkan jika laman layanan HTML yang membuat tetap terbuka.)

Meskipun demikian, jika Anda tahu bahwa Anda telah selesai dengan koneksi, pernyataan, atau set hasil sebelum skrip berakhir, sebaiknya tutup skrip tersebut secara manual dengan JdbcConnection.close(), JdbcStatement.close(), atau JdbcResultSet.close().

Menampilkan dialog pemberitahuan atau perintah juga menghentikan semua koneksi JDBC terbuka. Namun, elemen lain yang menampilkan UI yang berbeda—seperti menu atau dialog khusus dan bilah sisi dengan konten.

Google, Google Workspace, serta merek dan logo terkait adalah merek dagang dari Google LLC. Semua nama perusahaan dan produk lainnya adalah merek dagang masing-masing perusahaan yang terkait dengannya.