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