MongoDB 查詢語言(MQL)運算子使查詢中具備強大的過濾、比較與資料操作功能。 掌握這些運算子能幫助你撰寫具表達力的查詢,以有效檢索與更新收藏中的文件。
Accumulators
累加器運算子用於聚合管線中,對分組資料進行計算。
| Description | |
|---|---|
$avg |
$avg運算子計算文件在群組、桶或視窗中數值的平均值。 |
$bottom |
$bottom運算子會從依一或多個字段排序的查詢結果集傳回最後一份檔 |
$bottomN |
$bottomN運算符會從依一或多個字段排序的結果傳回最後 N 份檔 |
$count |
$count運算子用於計算符合查詢篩選條件的文件數量。 |
$first |
$first 運算子會根據群組的排序次序,傳回群組中的第一個值。 |
$firstN |
$firstN運算子會在查詢指定的一或多個字段上排序檔,並傳回符合篩選準則的第一個 N 檔案 |
$last |
$last 運算子會傳回按一或多個欄位排序的結果中的最後一個文件 |
$lastN |
$lastN 累加器運算子會傳回文件群組中的最後 N 個值。 |
$max |
$max運算子會從一組輸入值傳回最大值。 |
$maxN |
$maxN運算器根據指定的過濾條件擷取前 N 個值 |
$median |
$median運算子會計算一組文件中數值欄位的中位數值。 |
$min |
$min 運算子會取得指定欄位的最小值 |
$minN |
$minN運算子根據指定的篩選條件擷取底部 N 個值 |
$percentile |
$percentile運算子會計算符合篩選準則之數值的百分位數 |
$stddevpop |
$stddevpop運算子會計算指定值的標準差 |
$stddevsamp |
$stddevsamp運算子會計算指定值樣本的標準差,而不是整個母體的標準差 |
$sum |
$sum運算子會根據篩選準則計算欄位值的總和 |
$top |
$top運算符會從依一或多個字段排序的結果集傳回第一份檔 |
$topN |
$topN運算符會從依一或多個字段排序的結果傳回前 N 份檔 |
Aggregation
聚合運算子用於在聚合管線中對分組資料執行操作。
| Description | |
|---|---|
$addFields |
匯總管線中的$addFields階段是用來將新字段新增至檔。 |
$bucket |
$bucket 運算子會根據指定的邊界將輸入文件分組到不同的桶中。 |
$changeStream |
$changeStream階段會開啟變更數據流數據指標,以即時追蹤數據變更。 |
$collStats |
匯總管線中的$collStats階段可用來傳回集合的相關統計數據。 |
$convert |
$convert運算符會將表達式轉換成指定的類型 |
$densify |
$densify運算子會在陣列或集合中加入一連串值中缺失的資料點。 |
$documents |
$documents階段會從一組提供的檔建立管線。 |
$facet |
$facet允許在單一管線階段內執行多個平行匯總。 |
$fill |
$fill 階段可根據指定的方法和準則,在文件中填入遺漏的值。 |
$geoNear |
$geoNear 運算子會根據文件與地理空間點的鄰近性來尋找和排序文件,並傳回每個文件的距離資訊。 |
$group |
$group階段會依指定的標識符表達式將檔分組,並套用累加器表達式。 |
$indexStats |
$indexStats階段會傳回集合中每個索引的使用方式統計數據。 |
$isNumber |
$isNumber運算子會檢查指定的表達式是否為數值類型 |
$lookup |
彙總架構中的 $lookup 階段會用來與其他集合執行左方外部聯結。 |
$match |
匯總管線中的$match階段可用來篩選符合指定條件的檔。 |
$merge |
匯總管線中的$merge階段會將匯總的結果寫入指定的集合。 |
$out |
$out聚合管線中的階段會將產生的文件寫入指定的集合。 |
$redact |
$redact操作員會根據存取權限過濾文件內容。 |
$replaceWith |
DocumentDB 中的 $replaceWith 運算子在將文件替換為指定文件後,會回傳該文件 |
$sample |
DocumentDB 中的 $sample 運算子會隨機回傳若干文件 |
$set |
DocumentDB 中的 $set 運算子會更新或建立一個指定值的新欄位 |
$skip |
匯總管線中的$skip階段是用來略過輸入中指定數目的檔,並將其餘的文件傳遞至管線中的下一個階段。 |
$sort |
彙總管線中的 $sort 階段是用來依指定欄位或欄位,對管線中的文件進行排序。 |
$sortByCount |
彙總管線中的 $sortByCount 階段用於按指定的運算式來對文件進行分組,然後按遞減排序來對每個群組中的文件計數進行排序。 |
$toBool |
$toBool運算符會將表達式轉換成布爾型別 |
$toDate |
$toDate運算符會將支援的類型轉換成適當的 Date 物件。 |
$toDecimal |
$toDecimal運算符會將表達式轉換成十進位類型 |
$toDouble |
$toDouble運算符會將表達式轉換成 Double 值 |
$toInt |
$toInt運算符會將表達式轉換成 Integer |
$toLong |
$toLong運算子會將表達式轉換成 Long 值 |
$toObjectId |
$toObjectId運算符會將表達式轉換成 ObjectId |
$toString |
$toString運算符會將表達式轉換成 String |
$unset |
匯總管線中的$unset階段是用來從文件中移除指定的字段。 |
$unwind |
匯總架構中的$unwind階段可用來解構輸入檔中的陣列欄位,以輸出每個元素的檔。 |
算術表達式
算術運算子對數值進行數學運算。
| Description | |
|---|---|
$abs |
$abs 運算子會傳回數字的絕對值。 |
$add |
$add運算符會傳回兩個數位的總和或日期和數位的總和。 |
$ceil |
$ceil運算符會傳回大於或等於指定數位的最小整數。 |
$divide |
$divide 運算子會除以兩個數字,並傳回商數。 |
$exp |
$exp運算符會將 e 引發至指定的指數,並傳回結果 |
$floor |
$floor運算符會傳回小於或等於指定數位的最大整數 |
$ln |
$ln運算子會計算輸入的自然對數 |
$log |
$log運算子會計算指定基底中數位的對數 |
$log10 |
$log 10 運算子會計算基底 10 中指定數位的記錄 |
$multiply |
$multiply運算符會將輸入數值乘以 |
$pow |
$pow算符計算一個數值的值,並將其提升到指定指數的冪次方。 |
$round |
$round 運算子會將數字四捨五入至指定的小數位。 |
$sqrt |
$sqrt運算子會計算並傳回輸入編號的平方根 |
$subtract |
$subtract運算符會減去兩個數位,並傳回結果。 |
$trunc |
$trunc 運算子會將數字截斷至指定的小數位數。 |
Index |
陣列表達式
陣列運算式運算子對陣列及陣列元素執行操作。
| Description | |
|---|---|
$arrayElemAt |
$arrayElemAt會傳回位於指定數位件索引處的專案。 |
$arrayToObject |
$arrayToObject允許將陣列轉換成單一檔。 |
$concatArrays |
$concatArrays可用來將多個數組合並成單一陣列。 |
$filter |
$filter運算子會根據指定的條件篩選陣列中的元素。 |
$indexOfArray |
$indexOfArray運算子可用來搜尋數組中的專案,並傳回專案第一次出現的索引。 |
$isArray |
$isArray運算子可用來判斷指定的值是否為數位。 |
$map |
$map運算子允許將表達式套用至陣列中的每個專案。 |
$range |
$range運算子允許產生循序整數陣列。 |
$reduce |
$reduce運算符會將表達式套用至陣列中的每個元素,並將結果累積為單一值。 |
$reverseArray |
$reverseArray運算子可用來反轉數位列中的項目順序。 |
$slice |
$slice運算符會從數位中的任何項目之後傳回數位列的子集。 |
$sortArray |
$sortArray運算元有助於排序數位中的專案。 |
$zip |
$zip運算子允許將兩個或多個數位元素合併成單一陣列或陣列。 |
陣列查詢
陣列查詢運算子用於查詢和篩選陣列元素。
| Description | |
|---|---|
$all |
$all 運算子可協助尋找符合所有元素的陣列文件。 |
$elemMatch |
$elemMatch運算子回傳完整的陣列,並符合至少一個相符陣列元素的資格條件。 |
$size |
$size 運算子可用來查詢陣列欄位具有指定數目元素的文件。 |
陣列更新
陣列更新運算子用於修改陣列元素與結構。
| Description | |
|---|---|
$ |
$ 位置運算子會識別陣列中要更新的專案,而不需明確指定陣列中專案的位置。 |
$addToSet |
如果元素不存在,addToSet 運算子會將元素新增至陣列,同時確保集合內元素的唯一性。 |
$each |
$each 運算子用於 $addToSet 在 or $push 操作中,在一次更新操作中為陣列欄位新增多個元素。 |
$pop |
$pop運算子會移除陣列的第一個或最後一個元素。 |
$position |
$position用來指定陣列中應該插入新元素的位置。 |
$[] |
$[] 運算子可用來更新數位中符合查詢條件的所有元素。 |
$[identifier] |
$[識別符]運算子用於更新所有使用特定識別碼且符合查詢條件的元素。 |
$pull |
從陣列中移除值的所有實例。 |
$pullAll |
$pullAll運算子可用來從數位中移除指定值的所有實例。 |
$push |
$push運算子會將指定的值新增至檔中的陣列。 |
Bitwise
位元運算子對數字的二進位表示進行運算。
| Description | |
|---|---|
$bitAnd |
$bitAnd運算符會對整數值執行位 AND 運算,並以整數傳回結果。 |
$bitNot |
$bitNot運算符會對整數值執行位 NOT 運算,並以整數傳回結果。 |
$bitOr |
$bitOr運算符會對整數值執行位 OR 運算,並以整數傳回結果。 |
$bitXor |
$bitXor運算符會對整數值執行位 XOR 運算。 |
位元查詢
位元查詢運算子用於查詢並根據位元運算進行篩選。
| Description | |
|---|---|
$bitsAllClear |
$bitsAllClear運算子用於比對位遮罩中指定的所有位位置都清楚的文件。 |
$bitsAllSet |
bitsAllSet 命令可用來比對設定所有指定位位置的檔。 |
$bitsAnyClear |
$bitsAnyClear運算子會比對位遮罩中任何指定位元位置清楚的文件。 |
$bitsAnySet |
$bitsAnySet運算子會傳回任何指定位元位置設為 1 的文件。 |
Bitwise 更新
位元更新運算子用於透過位元運算修改數值。
| Description | |
|---|---|
$bit |
運算子 $bit 可用來對整數值執行位運算。 |
比較查詢
比較查詢運算子用於比較值並建立布林運算式。
| Description | |
|---|---|
$cmp |
$cmp運算符會比較兩個值 |
$eq |
$eq查詢運算符會將欄位的值與指定的值進行比較 |
$gt |
$gt查詢運算符會擷取字段的值大於指定值的檔 |
$gte |
$gte運算符會擷取欄位的值大於或等於指定值的檔 |
$in |
$in運算符會比對指定值陣列的欄位值 |
$lt |
$lt運算符會擷取字位值小於指定值的檔 |
$lte |
$lte運算符會擷取欄位的值小於或等於指定值的檔 |
$ne |
$ne運算符會擷取字段的值不等於指定值的檔 |
$nin |
$nin運算符會擷取字段的值不符合值清單的檔 |
條件表達式
條件式運算子在表達式中提供控制流程與條件邏輯。
| Description | |
|---|---|
$cond |
$cond運算符可用來評估條件,並根據結果傳回兩個表達式的其中一個。 |
$ifNull |
$ifNull運算子可用來評估表達式,並在表達式解析為 null 時傳回指定的值。 |
$switch |
$switch運算符可用來評估一系列條件,並根據評估為 true 的第一個條件傳回值。 |
資料大小
資料大小運算子用於決定資料結構與值的大小。
| Description | |
|---|---|
$binarySize |
$binarySize運算子可用來傳回二進位數據欄位的大小。 |
$bsonSize |
$bsonSize運算子在編碼為 BSON 時傳回文件的大小(以位元組為單位)。 |
日期表達式
日期表達式運算子對日期與時間值執行操作。
| Description | |
|---|---|
$dateAdd |
$dateAdd運算子會將指定數量的時間單位 (日、小時、月等) 新增至日期。 |
$dateDiff |
$dateDiff運算子以年、月、日等不同單位計算兩個日期之間的差異。 |
$dateFromParts |
$dateFromParts運算子會從個別元件建構日期。 |
$dateFromString |
$dateDiff運算子會將日期/時間字串轉換為日期物件。 |
$dateSubtract |
$dateSubtract運算子會從日期中減去指定的時間量。 |
$dateToParts |
$dateToParts運算子將日期分解為其各個部分,例如年、月、日等。 |
$dateToString |
$dateToString運算子會將日期物件轉換為格式化字串。 |
$dateTrunc |
$dateTrunc運算子會將日期截斷為指定的單位。 |
$dayOfMonth |
$dayOfMonth運算子會從日期擷取月份的日期。 |
$dayOfWeek |
$dayOfWeek運算子會從日期擷取星期幾。 |
$dayOfYear |
$dayOfYear運算子會從日期擷取年份中的日期。 |
$hour |
$hour運算符會將日期的小時部分傳回為介於 0 到 23 之間的數位。 |
$isoDayOfWeek |
$isoDayOfWeek運算子會以 ISO 8601 格式傳回工作日數字,範圍從 1 (星期一) 到 7 (星期日)。 |
$isoWeek |
$isoWeek運算符會傳回 ISO 8601 格式的年份周數,範圍從 1 到 53。 |
$isoWeekYear |
$isoWeekYear運算符會傳回 ISO 8601 格式的年份號碼,這與日曆年在年初或年底的日期不同。 |
$millisecond |
$millisecond運算符會從日期值擷取毫秒部分。 |
$minute |
$minute運算符會從日期值擷取分鐘部分。 |
$month |
$month運算符會從日期值擷取月份部分。 |
$second |
$second運算符會從日期值擷取秒部分。 |
$week |
$week運算符會將日期的周數傳回為介於 0 到 53 之間的值。 |
$year |
$year運算符會將日期的年份傳回為四位數的數位。 |
元素查詢
元素查詢運算子用於根據文件元素的存在與類型查詢。
| Description | |
|---|---|
$exists |
$exists運算符會擷取在其文件結構中包含指定字段的檔。 |
$type |
如果所選欄位為指定的類型,則$type運算符會擷取檔。 |
評估查詢
評估查詢運算子用於評估表達式並執行動態運算。
| Description | |
|---|---|
$expr |
$expr 運算子允許在查詢語言中使用彙總運算式,從而實現複雜的欄位比較和計算。 |
$jsonSchema |
$jsonSchema運算子會根據 JSON 結構描述定義驗證文件,以進行資料驗證和結構強制執行。 探索支援的功能和限制。 |
$mod |
$mod 運算子會對欄位值執行取餘數 (模數) 運算,並選取具有指定結果的文件。 |
$regex |
$regex運算符提供正規表達式功能,以在查詢中比對模式,允許彈性的字串比對和搜尋。 |
$text |
$text運算元會在索引字串字段的內容上執行文字搜尋,啟用全文搜索功能。 |
現場更新
欄位更新運算子用於在更新操作期間修改文件中的特定欄位。
| Description | |
|---|---|
$currentDate |
$currentDate運算符會將字段的值設定為目前日期,可以是 Date 或時間戳。 |
$inc |
$inc運算子會將欄位的值遞增指定的量。 |
$mul |
$mul運算符會將字段的值乘以指定的數位。 |
$rename |
$rename運算子允許在更新作業期間重新命名檔中的欄位。 |
$setOnInsert |
只有當 upsert 作業產生新檔的插入時,$setOnInsert運算子才會設定域值。 |
Geospatial
地理空間運算子對地理資料與空間關係執行操作。
| Description | |
|---|---|
$box |
$box 運算子會使用座標組來定義地理空間查詢的矩形區域。 |
$center |
$center 運算子會使用舊版座標組來指定 $geoWithin 查詢的圓形。 |
$centerSphere |
$centerSphere 運算子會使用球面幾何來為 $geoWithin 查詢指定一個圓形區域。 |
$geoIntersects |
$geoIntersects 運算子會選取位置欄位與指定 GeoJSON 物件交集的文件。 |
$geometry |
$geometry 運算子會指定地理空間查詢的 GeoJSON 幾何。 |
$geoWithin |
$geoWithin 運算子會選取位置欄位完全在指定幾何內的文件。 |
$maxDistance |
$maxDistance 運算子會指定地理空間查詢中兩個點之間可存在的最大距離。 |
$minDistance |
$minDistance運算子會指定地理空間查詢中兩個點之間必須存在的最小距離。 |
$near |
$near 運算子會傳回位置欄位接近指定點的文件,依距離排序。 |
$nearSphere |
$nearSphere 運算子會傳回位置欄位接近球體上指定點的文件,依球形表面上的距離排序。 |
$polygon |
$polygon 運算子會定義地理空間查詢的多邊形,讓您能夠尋找不規則形狀內的位置。 |
字面表達
字面表達式運算子用於彙整表達式中的字面值。
| Description | |
|---|---|
$literal |
$literal運算符會傳回指定的值,而不將其剖析為表達式,讓常值可用於匯總管線中。 |
邏輯查詢
邏輯查詢運算子結合布林運算式,使用邏輯運算。
| Description | |
|---|---|
$and |
$and運算符會聯結多個查詢子句,並傳回符合所有指定條件的檔。 |
$nor |
$nor 運算子會在表達式數位上執行邏輯 NOR,並擷取所有條件失敗的檔。 |
$not |
$not運算子會在指定的表達式上執行邏輯 NOT 運算,並選取不符合表達式的檔。 |
$or |
$or運算符會聯結具有邏輯 OR 的查詢子句,並傳回至少符合其中一個指定條件的檔。 |
其他
雜項操作員包括各種不屬於其他類別的公用事業與輔助操作員。
| Description | |
|---|---|
$getField |
$getField運算符允許從檔擷取指定字段的值。 |
$sampleRate |
$sampleRate運算符會根據指定的機率隨機取樣集合中的檔,對於統計分析和測試很有用。 |
雜項查詢
雜項查詢運算子包括各種用於查詢的工具與輔助運算子,這些運算子不屬於其他類別。
| Description | |
|---|---|
$comment |
$comment運算符會將批註新增至查詢,以協助識別記錄和分析工具輸出中的查詢。 |
$natural |
$natural運算符會強制查詢使用集合中檔的自然順序,以提供對檔排序和擷取的控制。 |
$rand |
$rand運算符會產生介於 0 到 1 之間的隨機浮點數。 |
物件表達
物件表達運算子對物件及其屬性執行操作。
| Description | |
|---|---|
$mergeObjects |
$mergeObjects運算符會將多個文件合併成單一檔 |
$objectToArray |
objectToArray 命令可用來將檔 (object) 轉換成索引鍵/值組的陣列。 |
$setField |
setField 命令可用來新增、更新或移除內嵌檔中的欄位。 |
Projection
投影運算子用於選擇和轉換文件中的欄位。
| Description | |
|---|---|
$meta |
$meta運算符會傳回具有傳回數據集的匯出元數據行。 |
集合表達式
集合表達式運算子對被視為集合的集合與陣列執行運算。
| Description | |
|---|---|
$allElementsTrue |
如果陣列中的所有元素評估為 true,則$allElementsTrue運算符會傳回 true。 |
$anyElementTrue |
如果陣列中的任何元素評估為 true,則 $anyElementTrue 運算子會傳回 true。 |
$setDifference |
$setDifference運算子會傳回一個集合,其中包含一個集合中存在但不存在於第二個集合中的元素。 |
$setEquals |
如果兩個集合具有相同的相異元素,則$setEquals運算符會傳回 true。 |
$setIntersection |
$setIntersection運算符會傳回出現在所有輸入陣列中的通用元素。 |
$setIsSubset |
$setIsSubset運算子會判斷一個陣列是否是第二個陣列的子集。 |
$setUnion |
$setUnion運算子會傳回一個陣列,其中包含輸入陣列中的所有唯一元素。 |
時間戳記表達式
時間戳記運算子對時間戳記值執行操作。
| Description | |
|---|---|
$tsIncrement |
$tsIncrement運算符會從時間戳值擷取遞增部分。 |
$tsSecond |
$tsSecond運算符會從時間戳值擷取秒部分。 |
變數表達式
變數表達式運算子用於定義和參考表達式中的變數。
| Description | |
|---|---|
$let |
$let運算子允許定義變數以用於指定的表達式,啟用複雜的計算並減少程式代碼重複。 |
視窗運算子
視窗運算子在指定視窗中執行一組文件的計算。
| Description | |
|---|---|
$covariancePop |
$covariancePop 運算子會回傳兩個數值運算式的共變異數 |
$covarianceSamp |
$covarianceSamp運算子會傳回兩個數值運算式樣本的共變異數 |
$denseRank |
$denseRank運算子會根據指定的排序順序,為分割區內的每一個文件指派並傳回位置排名 |
$derivative |
$derivative運算子會計算指定視窗內欄位值的平均變化率。 |
$documentNumber |
$documentNumber運算子會根據指定的排序順序,為分割區內的每一個文件指派並傳回位置 |
$expMovingAvg |
$expMovingAvg運算子會根據指定的文件數目來計算欄位的移動平均值,以保留最高權重 |
$integral |
$integral運算子會計算曲線下的面積,指定的文件範圍構成用於計算的相鄰文件。 |
$linearFill |
$linearFill運算符會使用線性內插補點,在檔序列中插補遺漏值。 |
$locf |
$locf運算符會將視窗化查詢中分割區中最後觀察到的非 Null 值向前傳播。 |
$rank |
$rank運算子會根據指定的排序順序,對分割區內的文件進行排名。 |
$shift usage on DocumentDB |
視窗運算子可在分區內移動數值,並返回移位後的數值。 |