運營商

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 視窗運算子可在分區內移動數值,並返回移位後的數值。