majiayu000 mongo-ts
MongoDB 命令列工具，直接執行查詢語法。
執行方式
Plugin 安裝後首次需 build：
cd ${PLUGIN_ROOT} && pnpm install && pnpm build
執行查詢：
node ${PLUGIN_ROOT}/dist/bin/mongots.js -u "mongodb://..." -q "db.users.find()"
命令選項
| 選項 | 說明 |
|---|---|
-q, --query <query> |
執行查詢字串（必填） |
-u, --uri <uri> |
MongoDB 連線字串 |
-d, --db <database> |
指定資料庫 |
-f, --format <type> |
輸出格式：table/json/csv/yaml（預設 table） |
--allow-write |
允許寫入操作（預設唯讀） |
--quiet |
靜默模式，只輸出資料 |
--verbose |
詳細模式 |
使用範例
# 查詢
mongots -u "mongodb://..." -q "db.users.find()"
mongots -q "db.users.findOne({name: 'test'})"
# 新增（需 --allow-write）
mongots --allow-write -q "db.users.insertOne({name: 'test'})"
# 更新
mongots --allow-write -q "db.users.updateOne({_id: '...'}, {\$set: {name: 'new'}})"
# 刪除
mongots --allow-write -q "db.users.deleteOne({_id: '...'})"
# 聚合
mongots -q "db.orders.aggregate([{\$group: {_id: '\$status'}}])"
# 管理
mongots -q "show dbs"
mongots -q "show collections"
mongots -q "db.stats()"
連線設定
優先順序：CLI 參數 > 環境變數 > 設定檔
首次使用
若不知道連線資訊，使用 AskUserQuestion 詢問以下環境變數，並詢問是否寫入 .env：
| 變數 | 說明 | 範例 |
|---|---|---|
MONGO_TS_URI |
MongoDB 連線字串（必填） | mongodb://localhost:27017/mydb |
MONGO_TS_DB |
預設資料庫（選填，覆蓋 URI） | mydb |
MONGO_TS_FORMAT |
輸出格式（選填） | table/json/csv/yaml |
MONGO_TS_ALLOW_WRITE |
允許寫入（選填） | true |
設定方式
- CLI 參數：
-u "mongodb://localhost:27017" - 環境變數：
.env檔案或系統環境變數 - 設定檔：
~/.mongots/config.json
{
"uri": "mongodb://localhost:27017",
"defaultDb": "mydb",
"format": "table",
"allowWrite": false
}
支援的查詢語法
| 類型 | 範例 |
|---|---|
| 查詢 | db.coll.find({}), db.coll.findOne({}) |
| 新增 | db.coll.insertOne({}), db.coll.insertMany([]) |
| 更新 | db.coll.updateOne({}, {}), db.coll.updateMany({}, {}) |
| 刪除 | db.coll.deleteOne({}), db.coll.deleteMany({}) |
| 聚合 | db.coll.aggregate([]) |
| 計數 | db.coll.countDocuments({}) |
| 索引 | db.coll.createIndex({}), db.coll.getIndexes() |
| 管理 | show dbs, show collections, db.stats() |
唯讀模式（預設）
預設為唯讀模式，使用 --allow-write 啟用寫入操作。
唯讀允許：find, findOne, countDocuments, aggregate（無 $out/$merge）, getIndexes, stats, show dbs/collections
需要 --allow-write：insert*, update*, delete*, drop*, createIndex, dropIndex
輸出格式
Table（預設，Markdown 格式）
_id | name | age
------------------------ | ----- | ---
507f1f77bcf86cd799439011 | Alice | 25
507f1f77bcf86cd799439012 | Bob | 30
JSON
mongots -q "db.users.find()" -f json
CSV
mongots -q "db.users.find()" -f csv
YAML
mongots -q "db.users.find()" -f yaml