CARL GITHUB
AI 概念圖：晨曦雲海上的觀測站，以受控觀測比喻設定資料存取範圍。
受控觀測：在設定的範圍內探索。 AI 生成概念圖。

首頁作品dbcli

CLI · 資料庫

dbcli

讓 agent 查資料， 也有明確界線。

查詢、檢查結構與診斷，由設定決定可用連線與操作權限。把資料庫工作交給 coding agent 前，先決定它能做什麼、哪些欄位不需要回傳。

看具體示例開啟使用文件

One concrete example

查詢可以做。敏感欄位先排除。

假設要讓 agent 檢查 users 資料表，卻不需要把密碼雜湊與身分資料交給它。先在初始化時選擇 query-only，再設定欄位黑名單。

使用示例 · 不是本次執行紀錄

dbcli / 文件示例

dbcli init

# 初始化時選擇 query-only，再排除欄位
dbcli blacklist column add users.password_hash
dbcli blacklist column add users.ssn

dbcli query "SELECT * FROM users"

文件描述的行為：回傳時省略黑名單欄位，並顯示安全提示。這裡沒有展示實際查詢結果。

01 / When to use

什麼時候用？

適合需要讓 coding agent 查詢資料、檢查結構或診斷資料庫的工作。支援 MySQL、PostgreSQL、MariaDB、MongoDB、Redis 與 Elasticsearch；各引擎的操作與連線方式仍需依文件配置。

02 / My work

我在這個作品上的工作

我維護這個資料庫 CLI，將連線設定、操作權限與欄位黑名單放進 agent 可使用的工具流程，並整理查詢、結構檢查與診斷的使用文件及公開示範。

03 / Boundaries

先理解限制，再開始。

兩種規則，各自管什麼？

操作權限

能做哪些操作

query-only 允許查詢，阻擋新增、更新與刪除。

欄位黑名單

哪些欄位不回傳

例如 users.ssn，查詢結果省略這個欄位。

兩種規則搭配使用；管理員可覆寫黑名單，仍需配置資料庫帳號本身的權限。

  • query-only 會阻擋 INSERT、UPDATE、DELETE；仍應配置資料庫帳號本身的權限。
  • 欄位黑名單會省略欄位，不是局部遮罩。管理員可覆寫黑名單，不能把它當成不可繞過的隔離層。
  • 查詢預設最多 1,000 筆，上限可由參數調整或停用；不是所有操作都有固定資料量上限。
  • 連線、各引擎支援與權限設定，請依實際使用版本核對。本頁沒有連接資料庫或驗證產品。

04 / Start here

從自己的專案開始。

先閱讀安裝、設定與完整操作文件，核對你使用的版本與環境。

安裝與完整使用文件閱讀公開安全示範

本文依 README 11b0f7b 整理。示例描述文件內容，不代表本次已執行或驗證產品。

返回作品總覽

繼續看看其他工具與方法。