Apidog Docs
🇨🇳 繁體中文
  • 🇺🇸 English
  • 🇯🇵 日本語
  • 🇪🇸 Español
  • 🇰🇷 한국인
  • 🇨🇳 简体中文
  • 🇵🇹 Português (Portugal)
  • 🇮🇩 Bahasa Indonesia
  • 🇧🇷 Português (Brasil)
  • 🇻🇳 Tiếng Việt
  • 🇨🇳 繁體中文
🇨🇳 繁體中文
  • 🇺🇸 English
  • 🇯🇵 日本語
  • 🇪🇸 Español
  • 🇰🇷 한국인
  • 🇨🇳 简体中文
  • 🇵🇹 Português (Portugal)
  • 🇮🇩 Bahasa Indonesia
  • 🇧🇷 Português (Brasil)
  • 🇻🇳 Tiếng Việt
  • 🇨🇳 繁體中文
🇨🇳 繁體中文
  • 🇺🇸 English
  • 🇯🇵 日本語
  • 🇪🇸 Español
  • 🇰🇷 한국인
  • 🇨🇳 简体中文
  • 🇵🇹 Português (Portugal)
  • 🇮🇩 Bahasa Indonesia
  • 🇧🇷 Português (Brasil)
  • 🇻🇳 Tiếng Việt
  • 🇨🇳 繁體中文
HomeLearning Center
Support CenterAPI ReferencesDownloadChangelog
HomeLearning Center
Support CenterAPI ReferencesDownloadChangelog
  1. 專案資源
  • Apidog 學習中心
  • 開始使用
    • Apidog 簡介
    • Apidog 中的基本概念
    • 導覽 Apidog
    • 快速開始
      • 概覽
      • 建立端點
      • 發送請求
      • 新增斷言
      • 建立測試情境
      • 分享 API 文件
      • 探索更多
    • 遷移到 Apidog
      • 概覽
      • 手動匯入
      • 排程匯入(綁定資料來源)
      • 匯入選項
      • 匯出資料
      • 匯入自
        • 從 Postman 匯入
        • 匯入 OpenAPI 規格
        • 匯入 cURL
        • 匯入 Markdown
        • 從 Insomnia 匯入
        • 從 apiDoc 匯入
        • 匯入 .har 檔案
        • 匯入 WSDL
  • Mock API 資料
    • 概述
    • Smart Mock
    • 自訂模擬
    • 模擬優先順序
    • 模擬腳本
    • 雲端模擬
    • 自託管 Runner 模擬
    • 模擬語言(Locales)
  • 帳號與偏好設定
    • 帳戶設定
    • 產生 OpenAPI 存取權杖
    • 通知
    • 語言設定
    • 快捷鍵
    • 網路代理設定
    • 備份資料
    • 更新 Apidog
    • 刪除帳戶
    • 實驗性功能
  • 傳送請求
    • 概覽
    • SSE 偵錯
    • MCP Client
    • Socket.IO
    • WebSocket
    • Webhook
    • SOAP 或 WebService
    • GraphQL
    • gRPC
    • 使用請求代理代理程式進行偵錯
    • 建立請求
      • 請求歷史記錄
      • 請求基礎
      • 參數與主體
      • 請求標頭
      • 請求設定
      • 偵錯請求
      • 將請求儲存為端點
      • HTTP/2
    • 驗證與授權
      • 概覽
      • CA 和用戶端憑證
      • 授權類型
      • Digest Auth
      • OAuth 1.0
      • OAuth 2.0
      • Hawk 驗證
      • Kerberos
      • NTLM
      • Akamai EdgeGrid
    • 回應和 Cookie
      • 檢視 API 回應
      • 管理 Cookie
      • 概覽
  • 開發和偵錯 API
    • 概觀
    • 產生請求
    • 傳送請求
    • 偵錯案例
    • 測試案例
    • 動態值
    • 驗證回應
    • Design-First 與 Request-First
    • 產生程式碼
    • 環境與變數
      • 概述
      • 使用變數
      • 環境管理
    • Vault 密鑰
      • 概覽
      • HashiCorp Vault
      • Azure Key Vault
      • AWS Secrets Manager
    • 動態值模組
      • Airline
      • 動物
      • 顏色
      • Commerce
      • Company
      • 資料庫
      • Datatype
      • 日期
      • Finance
      • Food
      • Git
      • Hacker
      • Helpers
      • 圖片
      • Internet
      • 位置
      • Lorem
      • 音樂
      • Number
      • Person
      • Phone
      • 科學
      • 字串
      • System
      • Vehicle
      • Word
    • 前置和後置處理器
      • 概覽
      • 斷言
      • 擷取變數
      • Wait
      • 安全性
      • 資料庫操作
        • 概述
        • MySQL
        • MongoDB
        • Redis
        • Oracle Client
      • 使用腳本
        • 概觀
        • 前置處理器指令碼
        • 後置處理器腳本
        • 公開腳本
        • Postman Scripts Reference
        • 呼叫其他程式語言
        • 使用 JS Libraries
        • 視覺化回應
        • 腳本範例
          • 斷言腳本
          • 使用變數
          • 修改請求
          • 其他範例
    • API 偵錯
      • AI Agent Debugger
      • A2A Debugger
  • 設計 API
    • 概覽
    • 建立新的 API 專案
    • 端點基礎
    • APl 設計指南
    • 模組
    • 設定多個請求主體範例
    • 元件
    • 通用欄位
    • 全域參數
    • 端點變更歷史
    • 留言
    • 批次端點管理
    • 自訂協定 API
    • Spec-first 模式 (Beta)
    • 安全方案
      • 概觀
      • 建立安全性方案
      • 使用 Security Scheme
      • 線上文件中的安全性方案
    • 進階功能
      • 自訂端點欄位
      • 關聯的測試場景
      • 端點狀態
      • 參數列表的外觀
      • 端點唯一識別
    • Schemas
      • 概述
      • 建立新 Schema
      • 建立 Schema
      • 從 JSON 等產生 Schema
      • oneOf, allOf, anyOf
      • 使用 Discriminator
  • API 測試
    • 概述
    • 測試情境
      • 建立測試情境
      • 在請求之間傳遞資料
      • 流程控制條件
      • 從端點和端點案例同步資料
      • 從其他專案匯入端點和端點案例
      • 匯出測試情境
    • 測試報告
      • 測試報告
    • 執行測試情境
      • 執行測試場景
      • 批次執行測試場景
      • 資料驅動測試
      • 共享測試資料
      • 排程任務
      • 管理來自其他專案的 API 執行環境
    • 測試套件
      • 概述
      • 建立測試套件
      • 編排測試套件
      • 在本機執行測試套件
      • 透過 CLI 執行測試套件
      • 排程任務
    • 測試 API
      • 整合測試
      • 效能測試
      • 端對端測試
      • 迴歸測試
      • 契約測試
    • Apidog CLI
      • 概覽
      • 安裝並執行 Apidog CLI
      • Apidog CLI 選項
    • CI/CD
      • 概述
      • 與 Github Actions 整合
      • Integrate with Gitlab
      • 與 Jenkins 整合
      • 透過 Git Commit 觸發測試
  • 發布 API 文件
    • 概述
    • 支援的 API 技術
    • 快速分享
    • 檢視 API 文件
    • Markdown 文件
    • 發佈文件網站
    • 自訂登入頁面
    • 自訂版面配置
    • 自訂 CSS、JavaScript、HTML
    • 自訂網域
    • AI Features
    • SEO 設定
    • 進階設定
      • 文件搜尋
      • CORS Proxy
      • 整合 Google Analytics
      • 資料夾樹設定
      • 可見性設定
      • 在文件 URL 中嵌入值
    • API 版本
      • 概述
      • 建立 API 版本
      • 發佈 API 版本
      • 使用 API 版本分享端點
  • 分支
    • 概觀
    • 建立 Sprint 分支
    • 在分支中測試 API
    • 在分支中設計 API
    • 合併 Sprint 分支
    • 管理 Sprint 分支
    • AI Branch (Beta)
  • AI 功能
    • 概觀
    • 啟用 AI 功能
    • 產生測試案例
    • 使用 AI 修改 Schema
    • 端點合規性檢查
    • API 文件完整性檢查
    • AI 驅動的欄位命名
    • 常見問題
  • Apidog MCP 伺服器
    • 概覽
    • 將 Apidog 專案連接至 AI
    • 將已發布的文件連接至 AI
    • 將 OpenAPI 檔案連接到 AI
  • Apidog Europe
    • Apidog Europe
  • 最佳實務
    • 處理 API 簽章
    • 存取受 OAuth 2.0 保護的 API
    • 協作工作流程
    • 管理驗證狀態
  • 離線空間
    • 概述
  • 管理
    • 管理專案
      • 管理專案
      • 通知設定
      • 管理專案成員
      • 專案資源
        • 資料庫連線
        • Git 連線
    • 管理團隊
      • 管理團隊
      • 管理團隊成員
      • 團隊活動
      • 團隊角色與權限
      • 團隊資源
        • General Runner
        • 團隊變數
        • 請求代理代理程式
      • 即時協作
        • 團隊協作
    • 入門檢查清單
      • 基本概念
      • 入門指南
    • 管理組織
      • 管理組織
      • 組織角色與權限
      • 方案管理
        • 組織中的帳單管理員
      • 單一登入 (SSO)
        • SSO 概覽
        • 設定 Microsoft Entra ID
        • 設定 Okta
        • 為組織設定 SSO
        • 管理使用者帳戶
        • 將群組對應到團隊
      • SCIM 佈建
        • SCIM 佈建簡介
        • Microsoft Entra ID
        • Okta
      • 組織資源
        • 自託管 Runner
  • 帳單
    • 概觀
    • 點數
    • 升級您的方案
    • 替代付款方式
    • 管理訂閱
    • 將付費團隊移至組織
  • 附加元件
    • API Hub
    • Apidog Intellij IDEA 外掛
    • 瀏覽器擴充功能
      • Chrome
      • Microsoft Edge
    • 請求代理
      • Web 中的請求代理
      • 共用文件中的請求代理
      • 用戶端中的請求代理
  • 資料與安全
    • 資料儲存與安全性
    • 使用者資料隱私與安全
    • 請求路由與資料安全
  • 參考
    • API 設計優先方法
    • Apidog OpenAPI 規格擴充
    • JSONPath
    • XPath
    • 正規表示式
    • JSON Schema
    • CSV 檔案格式
    • 安裝 Java 環境
    • Runner 部署環境
    • Apidog Markdown 語法
    • Apidog Swagger 擴充
      • 概述
      • x-apidog-folder
      • x-apidog-status
      • x-apidog-name
      • x-apidog-maintainer
    • Apidog JSON Schema 擴充
      • 概述
      • x-apidog-mock
      • x-apidog-orders
      • x-apidog-enum
  • 支援中心
  1. 專案資源

資料庫連線

你可以在專案設定中設定資料庫連線詳細資料。設定完成後,你可以在端點除錯與測試期間,透過在前置/後置處理器步驟中新增資料庫操作來使用這些連線。這可讓你無縫地從資料庫讀取或寫入資料。
database-connection-settings.png
Apidog 免費版本支援連線至以下資料庫:
MySQL
SQL Server:支援 SQL Server 2014 及更新版本
Oracle(連線至 Oracle 資料庫需要安裝 Oracle Client)
Db2
PostgreSQL
透過升級,你也可以連線至:
ClickHouse(需要 Basic 方案)
MongoDB(需要 Basic 方案)
Redis(需要 Basic 方案)

設定資料庫連線#

請依照以下步驟在 Apidog 中設定資料庫連線:
1.
開啟 Project Settings → Database Connections。
project-database-connection-settings.png
2.
點擊右上角的 + New 以建立資料庫連線。
3.
從可用選項中選擇資料庫類型,並填寫必要的連線資訊,例如主機、連接埠、資料庫名稱、使用者名稱和密碼。建議使用 variables 來填寫。完全以變數填寫的資料庫連線可以儲存在雲端以便協作。
DANGER
重要! 使用變數設定資料庫連線時,請留意資料安全影響。
database-connection-details.png
4.
除了使用使用者名稱和密碼的本機連線方式外,你也可以透過 SSH tunnel 建立更安全的連線,以更好地保護資料傳輸。
database-connection-via-ssh.png
5.
點擊 Save,此連線即可用於前置/後置處理器。

使用資料庫連線#

你可以在端點請求的前置/後置處理器中新增「Database Operations」以參照資料庫連線。新增後,你可以在「Database Operations」中指定資料庫連線。
database-connection-pre-post-processors.png
以下是資料庫操作的具體步驟:
1.
在 Run 分頁(Design Mode)或 Request 分頁(Request Mode)中,前往前置/後置處理器。
2.
將游標移至 Add PreProcessor 或 Add PostProcessor,並選擇 Database Operation。
adding-database-operation.png
3.
為資料庫操作命名並設定資料庫連線。請確保所選的「Database Connection」已正確設定。了解更多。
configuring databse connection.png
4.
輸入 SQL 命令。命令中支援 {{variables}} 等變數。
5.
啟用 Extract Result To Variable(支援 JSONPath),並視需要切換 Console Log。
6.
點擊 Send 以執行端點請求,並在主控台中查看結果。
image.png
如果你在自動化測試中使用 Database Operation——無論是作為測試步驟,或用於端點請求的前置/後置處理器——都可以依照上述相同步驟進行設定與使用。
INFO
Apidog 支援標準 SQL 查詢,但不支援預存程序等複雜 SQL 操作。

重要注意事項#

在透過請求執行資料庫操作之前,請確保已正確儲存設定的資料庫連線:
如果你的資料庫連線使用變數並儲存在雲端,請務必在相關變數的 Current Value 欄位中設定實際的資料庫詳細資料(例如主機、使用者名稱、密碼等)。或者,你也可以使用設定變數的方法來動態設定這些值。
configuring-variables-current-value.png
如果資料庫連線使用固定文字並儲存在本機,你需要在 Project Settings → Database Connection 中輸入實際的資料庫詳細資料(例如主機、使用者名稱、密碼等)。
entering-database-connection-credentials.png
如果你需要透過 CLI 執行包含資料庫連線的測試情境,點擊此處查看詳細注意事項
如果你需要透過 Runner 執行包含資料庫連線的測試情境,點擊此處查看詳細注意事項。

儲存機制與資料安全#

目前,Apidog 提供兩種儲存資料庫連線的方式:
儲存在 Apidog Cloud:如果資料庫連線完全使用變數設定,則會以變數形式儲存在 Apidog 的雲端伺服器上。
儲存在本機:如果資料庫連線使用固定文字設定,則會以純文字形式儲存在本機設定檔中。

儲存機制之間的差異#

儲存機制儲存方式優點缺點
Cloud在設定中使用變數1. 可與團隊成員進行更便利的協作。
2. 透過 CI、Runner 等方式執行測試情境時,你可以使用變數設定資料庫連線詳細資料,而不必維護本機檔案。
⚠️ 當在變數初始值中使用明文時,資料庫名稱和密碼等資料將以明文傳輸至 Apidog 的雲端伺服器,造成資料安全風險(使用變數的目前值會讓資料儲存在本機,消除此風險)。建議使用 vault variables 以避免資料安全風險。
Local在設定中使用固定文字儲存在本機,無安全風險1. 協作性較差;每位團隊成員都必須個別設定資料庫連線。
2. 透過 CI、Runner 或類似工具執行測試情境時,你需要為資料庫連線維護專用的本機檔案。
WARNING
為了在良好的使用者體驗與資料安全之間取得平衡,Apidog 建議將資料庫連線儲存在雲端,並使用 Vault variables 來確保資料安全。強烈不建議在與資料庫連線相關的變數初始值中使用明文,因為這可能導致重大的資料安全風險。
Modified at 2026-06-11 10:26:02
Previous
管理專案成員
Next
Git 連線
Built with