Bạn có thể cấu hình chi tiết kết nối cơ sở dữ liệu trong phần cài đặt dự án. Sau khi cấu hình, bạn có thể sử dụng các kết nối này trong quá trình gỡ lỗi và kiểm thử endpoint bằng cách thêm thao tác cơ sở dữ liệu vào các bước bộ xử lý trước/sau. Điều này cho phép bạn đọc từ hoặc ghi vào cơ sở dữ liệu một cách liền mạch.Phiên bản miễn phí của Apidog hỗ trợ kết nối với các cơ sở dữ liệu sau:SQL Server: Hỗ trợ SQL Server 2014 và các phiên bản mới hơn
Oracle (Kết nối với cơ sở dữ liệu Oracle yêu cầu cài đặt Oracle Client) ClickHouse (Yêu cầu gói Basic)
MongoDB (Yêu cầu gói Basic)
Redis (Yêu cầu gói Basic)
Cấu hình kết nối cơ sở dữ liệu#
Làm theo các bước sau để thiết lập kết nối cơ sở dữ liệu trong Apidog:1.
Mở Project Settings → Database Connections.
2.
Nhấp vào + New ở góc trên bên phải để tạo kết nối cơ sở dữ liệu.
3.
Chọn loại cơ sở dữ liệu từ các tùy chọn có sẵn, điền thông tin kết nối cần thiết như host, cổng, tên cơ sở dữ liệu, tên người dùng và mật khẩu. Khuyến nghị sử dụng biến để điền. Các kết nối cơ sở dữ liệu được điền hoàn toàn bằng biến có thể được lưu trên cloud để cộng tác.
4.
Ngoài phương thức kết nối cục bộ bằng tên người dùng và mật khẩu, bạn cũng có thể thiết lập kết nối an toàn hơn thông qua đường hầm SSH để bảo vệ tốt hơn quá trình truyền dữ liệu.
5.
Nhấp vào Save, và kết nối này có thể được sử dụng trong các bộ xử lý trước/sau.
Sử dụng kết nối cơ sở dữ liệu#
Bạn có thể thêm "Database Operations" trong các bộ xử lý trước/sau cho một yêu cầu endpoint để tham chiếu đến kết nối cơ sở dữ liệu. Sau khi thêm, bạn có thể chỉ định kết nối cơ sở dữ liệu trong "Database Operations".Dưới đây là các bước cụ thể cho thao tác cơ sở dữ liệu:1.
Trong tab Run (Design Mode) hoặc tab Request (Request Mode), điều hướng đến các bộ xử lý trước/sau.
2.
Di chuột qua Add PreProcessor hoặc Add PostProcessor và chọn Database Operation.
3.
Đặt tên cho thao tác cơ sở dữ liệu và cấu hình kết nối c ơ sở dữ liệu. Đảm bảo "Database Connection" đã chọn được thiết lập chính xác. Tìm hiểu thêm. 4.
Nhập lệnh SQL. Các biến như {{variables}} được hỗ trợ trong lệnh.
5.
Bật Extract Result To Variable (hỗ trợ JSONPath) và bật/tắt Console Log nếu cần.
6.
Nhấp vào Send để thực thi yêu cầu endpoint, và kiểm tra kết quả trong console.
Apidog hỗ trợ các truy vấn SQL tiêu chuẩn nhưng không hỗ trợ các thao tác SQL phức tạp như stored procedure.
Lưu ý quan trọng#
Trước khi thực thi các thao tác cơ sở dữ liệu thông qua yêu cầu, hãy đảm bảo kết nối cơ sở dữ liệu đã cấu hình được lưu đúng cách:Nếu kết nối cơ sở dữ liệu của bạn sử dụng biến và được lưu trữ trên cloud, hãy đảm bảo đặt chi tiết cơ sở dữ liệu thực tế (như host, tên người dùng, mật khẩu, v.v.) trong trường Current Value của các biến liên quan. Ngoài ra, bạn có thể sử dụng phương thức đặt biến để cấu hình động các giá trị này.
Nếu kết nối cơ sở dữ liệu sử dụng văn bản cố định và được lưu trữ cục bộ, bạn cần nhập chi tiết cơ sở dữ liệu thực tế (như host, tên người dùng, mật khẩu, v.v.) trong Project Settings → Database Connection.
Cơ chế lưu trữ và bảo mật dữ liệu#
Hiện tại, Apidog cung cấp hai cách để lưu trữ kết nối cơ sở dữ liệu:Được lưu trữ trong Apidog Cloud: Nếu kết nối cơ sở dữ liệu được cấu hình hoàn toàn bằng biến, nó sẽ được lưu trữ dưới dạng biến trên máy chủ cloud của Apidog.
Được lưu trữ cục bộ: Nếu kết nối cơ sở dữ liệu được cấu hình bằng văn bản cố định, nó sẽ được lưu dưới dạng văn bản thuần trong tệp cấu hình cục bộ.
Khác biệt giữa các cơ chế lưu trữ#
| Cơ chế lưu trữ | Phương thức lưu trữ | Ưu điểm | Nhược điểm |
|---|
| Cloud | Sử dụng biến trong cấu hình | 1. Cho phép cộng tác thuận tiện hơn với các thành viên trong nhóm.
2. Khi chạy các kịch bản kiểm thử thông qua CI, Runner, v.v., bạn có thể sử dụng biến để đặt chi tiết kết nối cơ sở dữ liệu thay vì duy trì các tệp cục bộ. | ⚠️ Khi văn bản thuần được sử dụng trong giá trị ban đầu của biến, dữ liệu như tên cơ sở dữ liệu và mật khẩu sẽ được truyền dưới dạng văn bản thuần đến máy chủ cloud của Apidog, gây ra rủi ro bảo mật dữ liệu (sử dụng giá trị hiện tại cho biến sẽ giữ dữ liệu được lưu trữ cục bộ, loại bỏ rủi ro này). Khuyến nghị sử dụng biến vault để tránh rủi ro bảo mật dữ liệu. |
| Cục bộ | Sử dụng văn bản cố định trong cấu hình | Được lưu trữ cục bộ, không có rủi ro bảo mật | 1. Khả năng cộng tác kém; mỗi thành viên trong nhóm phải tự cấu hình kết nối cơ sở dữ liệu.
2. Khi chạy các kịch bản kiểm thử thông qua CI, Runner hoặc các công cụ tương tự, bạn cần duy trì một tệp cục bộ chuyên dụng cho các kết nối cơ sở dữ liệu. |
Để cân bằng giữa trải nghiệm người dùng tốt và bảo mật dữ liệu, Apidog khuyến nghị lưu kết nối cơ sở dữ liệu trên cloud và sử dụng biến Vault để đảm bảo an toàn dữ liệu. Rất không khuyến khích sử dụng văn bản thuần trong giá trị ban đầu của các biến liên quan đến kết nối cơ sở dữ liệu, vì điều này có thể dẫn đến rủi ro bảo mật dữ liệu đáng kể.
