Phiên bản 1.0 và 1.1 của giao thức bảo mật TLS đã bị vô hiệu hoá. Để thiết lập kết nối, hãy sử dụng TLS 1.2 trở lên.
Google Apps Script có thể kết nối với cơ sở dữ liệu bên ngoài thông qua dịch vụ JDBC, một trình bao bọc xung quanh công nghệ Kết nối cơ sở dữ liệu Java tiêu chuẩn. Dịch vụ JDBC hỗ trợ cơ sở dữ liệu Google Cloud SQL cho MySQL, MySQL, Microsoft SQL Server, Oracle và PostgreSQL.
Nếu bảng tính của bạn đang phát triển quá lớn hoặc bạn gặp phải vấn đề về thời gian chờ với các phép tính phức tạp, thì việc chuyển dữ liệu sang cơ sở dữ liệu bên ngoài có thể cải thiện đáng kể hiệu suất và độ tin cậy.
Để 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 đến cơ sở dữ liệu, sau đó thực hiện các thay đổi bằng cách gửi câu lệnh SQL.
Cơ sở dữ liệu Google Cloud SQL
Google Cloud SQL cho phép bạn tạo cơ sở dữ liệu quan hệ nằm trong đám mây của Google. Cloud SQL có thể phát sinh chi phí dựa trên mức sử dụng của bạn.
Tạo phiên bản Google Cloud SQL bằng cách làm theo các bước được liệt kê trong phần Bắt đầu nhanh với 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 cơ sở dữ liệu Google Cloud SQL bằng dịch vụ JDBC của Apps Script:
- (Nên dùng) Kết nối bằng Jdbc.getCloudSqlConnection
- Kết nối bằng Jdbc.getConnection
Cả hai đều hợp lệ, nhưng phương thức thứ hai yêu cầu bạn phải uỷ quyền cho một tập hợp dải IP để truy cập vào cơ sở dữ liệu.
Sử dụng Jdbc.getCloudSqlConnection (nên dùng)
Phương thức này tạo kết nối đến một phiên bản Google Cloud SQL MySQL bằng phương thức
Jdbc.getCloudSqlConnection. URL cơ sở dữ liệu có dạng jdbc:google:mysql://subname, trong đó
subname là Tên kết nối phiên bản 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 SQL Server, hãy xem Jdbc.getConnection.
Sử dụng Jdbc.getConnection
Để sử dụng phương thức này, bạn phải uỷ quyền cho một số dải địa chỉ IP Định tuyến liên miền không có lớp (CIDR) để 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, hãy hoàn tất các bước sau:
Trong phiên bản Google Cloud SQL, hãy uỷ quyền cho các dải IP, mỗi lần một dải từ nguồn dữ liệu này.
Sao chép URL được gán cho cơ sở dữ liệu của bạn; URL này phải có dạng
jdbc:mysql:subname.
Sau khi uỷ quyền cho các dải IP này, hãy tạo kết nối đến phiên bản Google Cloud SQL bằng một trong các phương thức Jdbc.getConnection và URL mà bạn đã sao chép trước đó.
Các cơ sở dữ liệu khác
Nếu bạn đã có cơ sở dữ liệu MySQL, Microsoft SQL Server, Oracle hoặc PostgreSQL của riêng mình, hãy 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 dịch vụ JDBC của Apps Script , trong phần cài đặt cơ sở dữ liệu bạn phải uỷ quyền cho các dải IP từ nguồn dữ liệu này.
Dịch vụ JDBC chỉ có thể kết nối với các cổng 1025 trở lên. Đảm bảo cơ sở dữ liệu của bạn không phục vụ trên một cổng thấp hơn.
Sau khi các danh sách cho phép này được thiết lập, hãy tạo kết nối đến cơ sở dữ liệu bằng một trong các Jdbc.getConnection và URL của cơ sở dữ liệu.
Mã mẫu
Mã mẫu sau đây giả định rằng bạn đang kết nối với cơ sở dữ liệu Google Cloud SQL và tạo kết nối cơ sở dữ liệu bằng phương thức Jdbc.getCloudSqlConnection. Đối với các cơ sở dữ liệu khác, bạn phải sử dụng phương thức Jdbc.getConnection để 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 về JDBC.
Tạo cơ sở dữ liệu, người dùng và bảng
Hầu hết nhà phát triển đều sử dụng công cụ dòng lệnh MySQL để tạo cơ sở dữ liệu, người dùng và bảng. Tuy nhiên, bạn có thể thực hiện điều tương tự trong Apps Script, như minh hoạ trong ví dụ sau. Tạo ít nhất một người dùng khác để tập lệnh của bạn không phải luôn kết nối với cơ sở dữ liệu dưới dạng root.
Ghi vào cơ sở dữ liệu
Các ví dụ sau đây minh hoạ cách ghi một bản ghi vào cơ sở dữ liệu cũng như một lô gồm 500 bản ghi. Việc phân lô là rất quan trọng đối với các thao tác hàng loạt.
Các câu lệnh được tham số hoá được sử dụng, trong đó các biến được biểu thị bằng ?. Để
ngăn chặn các cuộc tấn công chèn mã SQL,
hãy sử dụng các câu lệnh được tham số hoá để thoát khỏi tất cả dữ liệu do người dùng cung cấp.
Đọc từ cơ sở dữ liệu
Ví dụ này minh hoạ cách đọc một số lượng lớn bản ghi từ cơ sở dữ liệu, lặp lại tập kết quả khi cần.
Đóng kết nối
Kết nối JDBC sẽ tự động đóng khi tập lệnh hoàn tất việc thực thi. (Các lệnh gọi đơn lẻ
google.script.run được tính là một lần thực thi hoàn chỉnh, ngay cả khi trang dịch vụ HTML đã thực hiện lệnh gọi vẫn mở.)
Tuy nhiên, nếu bạn biết mình đã hoàn tất kết nối, câu lệnh hoặc tập kết quả
trước khi kết thúc tập lệnh, hãy đóng các kết nối, câu lệnh hoặc tập kết quả đó theo cách thủ công bằng cách gọi
JdbcConnection.close,
JdbcStatement.close,
hoặc
JdbcResultSet.close.
Việc hiển thị hộp thoại cảnh báo hoặc lời nhắc cũng sẽ chấm dứt mọi kết nối JDBC đang mở. Tuy nhiên, các thành phần khác trên giao diện người dùng hiển thị (như trình đơn hoặc hộp thoại tuỳ chỉnh và thanh bên có nội dung tuỳ chỉnh) thì không.
Google, Google Workspace và những nhãn hiệu cũng như biểu tượng có liên quan là 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 mà chúng liên kết.