JDBC

Apps Script có thể kết nối với các cơ sở dữ liệu bên ngoài thông qua Dịch vụ JDBC, một trình bao bọc theo tiêu chuẩn Công nghệ Kết nối cơ sở dữ liệu Java. Dịch vụ JDBC hỗ trợ Google Cloud SQL cho MySQL, MySQL, Microsoft SQL Máy chủ và cơ sở dữ liệu Oracle.

Để cập nhật cơ sở dữ liệu bên ngoài bằng JDBC, tập lệnh của bạn phải mở một kết nối vào cơ sở dữ liệu rồi thay đổi bằng cách gửi câu lệnh SQL.

Cơ sở dữ liệu Google Cloud SQL

Google Cloud SQL giúp bạn tạo cơ sở dữ liệu quan hệ trực tiếp trên đám mây của Google. Lưu ý rằng Cloud SQL có thể phải trả phí dựa trên mức sử dụng của bạn.

Bạn có thể tạo một phiên bản Google Cloud SQL bằng cách làm theo các bước nêu trong Bắt đầu nhanh Cloud SQL.

Tạo kết nối Google Cloud SQL

Có 2 cách để thiết lập kết nối với Google Cloud SQL bằng dịch vụ JDBC của Apps Script:

Các phương pháp này được giải thích ở bên dưới. Cả hai đều hợp lệ, nhưng phương thức thứ hai yêu cầu bạn cấp quyền cho một nhóm dải IP để truy cập vào cơ sở dữ liệu của bạn.

Phương thức này tạo kết nối với một phiên bản Google Cloud SQL MySQL bằng cách sử dụng Jdbc.getCloudSqlConnection(url) . URL cơ sở dữ liệu có dạng jdbc:google:mysql://subname, trong đó subnametên kết nối phiên bản của MySQL được liệt kê trên trang Tổng quan về phiên bản Cloud SQL trong Bảng điều khiển Google Cloud.

Để kết nối với Cloud SQL Server, hãy xem Jdbc.getConnection(url).

Sử dụng Jdbc.getConnection(url)

Để sử dụng phương thức này, bạn phải cấp quyền cho một số Định tuyến liên miền không phân lớp (CIDR) Dải địa chỉ IP để các máy chủ của Apps Script có thể kết nối với cơ sở dữ liệu của bạn. Trước khi chạy tập lệnh của bạn, hãy hoàn tất các bước sau:

  1. Trong phiên bản Google Cloud SQL, uỷ quyền dải IP, từng thông tin một từ nguồn dữ liệu này.

  2. Sao chép URL đã được gán vào cơ sở dữ liệu của bạn; nó sẽ có biểu mẫu jdbc:mysql:subname.

Sau khi cho phép các dải IP này, bạn có thể tạo kết nối với Phiên bản Google Cloud SQL bằng một trong Jdbc.getConnection(url) và URL mà bạn đã sao chép ở trên.

Các cơ sở dữ liệu khác

Nếu đã có cơ sở dữ liệu MySQL, Microsoft SQL Server hoặc Oracle, bạn có thể kết nối với cơ sở dữ liệu đó thông qua dịch vụ JDBC của Apps Script.

Tạo các kết nối cơ sở dữ liệu khác

Để tạo kết nối cơ sở dữ liệu bằng Apps Script Dịch vụ JDBC, trong phần cài đặt cơ sở dữ liệu bạn phải cho phép dải IP từ nguồn dữ liệu này.

Sau khi có các danh sách cho phép này, bạn có thể tạo kết nối với cơ sở dữ liệu sử dụng một trong Jdbc.getConnection(url) và URL cơ sở dữ liệu của bạn.

Mã mẫu

Mã mẫu dưới đây giả định bạn đang kết nối với một cơ sở dữ liệu Google Cloud SQL, và tạo kết nối cơ sở dữ liệu bằng Jdbc.getCloudSqlConnection(url) . Đối với các cơ sở dữ liệu khác, bạn phải sử dụng Jdbc.getConnection(url) để tạo kết nối cơ sở dữ liệu.

Để biết thêm thông tin về các phương thức JDBC, hãy xem Tài liệu Java cho JDBC.

Tạo cơ sở dữ liệu, người dùng và bảng

Hầu hết các nhà phát triển sử dụng Công cụ dòng lệnh của MySQL để tạo cơ sở dữ liệu, người dùng và bảng. Tuy nhiên, bạn vẫn có thể thực hiện tương tự trong Apps Script, như minh hoạ dưới đây. Bạn nên tạo ít nhất một để tập lệnh của bạn không phải lúc nào cũng phải kết nối với cơ sở dữ liệu 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);
  }
}

Ghi vào cơ sở dữ liệu

Các ví dụ dưới đây minh hoạ cách ghi một bản ghi vào cơ sở dữ liệu cũng như một lô 500 bản ghi. Việc phân lô là rất quan trọng đối với các hoạt động hàng loạt.

Ngoài ra, xin lưu ý việc sử dụng các câu lệnh có tham số, trong đó các biến được được biểu thị bằng ?. Để ngăn chặn tấn công chèn SQL, bạn nên sử dụng các câu lệnh có tham số để thoát khỏi mọi dữ liệu do người dùng cung cấp.

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);
  }
}

Đọc từ cơ sở dữ liệu

Ví dụ này minh hoạ cách đọc một lượng lớn bản ghi từ cơ sở dữ liệu, lặp lại tập hợp kết quả nếu cần.

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);
  }
}

Đóng kết nối

Kết nối JDBC tự động đóng khi một tập lệnh hoàn tất việc thực thi. (Tiếp tục xin lưu ý rằng một google.script.run lệnh gọi được tính là thực thi hoàn tất, ngay cả khi trang dịch vụ HTML đã thực hiện cuộc gọi vẫn đang mở).

Tuy nhiên, nếu bạn biết rằng bạn đã hoàn tất với một kết nối, câu lệnh hoặc tập hợp kết quả trước khi kết thúc tập lệnh, bạn nên đóng chúng theo cách thủ công bằng cách gọi JdbcConnection.close()! JdbcStatement.close(), hoặc JdbcResultSet.close().

Hiện hộp thoại cảnh báo hoặc lời nhắc cũng chấm dứt mọi kết nối JDBC đang mở. Tuy nhiên, giao diện người dùng hiển thị khác các phần tử—như trình đơn hoặc hộp thoại tuỳ chỉnh và thanh bên có tuỳ chỉnh nội dung thì không.

Google, Google Workspace cùng các nhãn hiệu và biểu trưng có liên quan là các nhãn hiệu của Google LLC. Tất cả các tên sản phẩm và công ty khác là nhãn hiệu của những công ty liên kết với các nhãn hiệu đó.​