Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# APIsMongoDB, operasi, dan tipe data yang didukung di Amazon DocumentDB
Amazon DocumentDB (dengan kompatibilitas MongoDB) adalah layanan basis data dokumen yang cepat, dapat diskalakan, sangat tersedia, dan terkelola penuh yang mendukung beban kerja MongoDB. Amazon DocumentDB kompatibel dengan MongoDB 3.6, 4.0, 5.0, dan 8.0. APIs Bagian ini mencantumkan fungsionalitas yang didukung. Untuk dukungan menggunakan APIs MongoDB dan driver, silakan berkonsultasi dengan Forum Komunitas MongoDB. Untuk dukungan menggunakan layanan Amazon DocumentDB, silakan hubungi tim dukungan yang AWS sesuai. Untuk perbedaan fungsional antara Amazon DocumentDB dan MongoDB, silakan lihat [Perbedaan fungsional: Amazon DocumentDB dan MongoDB](functional-differences.md).
Perintah dan operator MongoDB yang hanya berlaku untuk internal atau tidak berlaku untuk layanan terkelola penuh tidak didukung dan tidak termasuk dalam daftar fungsi yang didukung.
Kami telah menambahkan lebih dari 50\$1 kemampuan tambahan sejak diluncurkan, dan akan terus bekerja mundur dari pelanggan kami untuk memberikan kemampuan yang mereka butuhkan. Untuk informasi tentang peluncuran terbaru, lihat [Pengumuman Amazon DocumentDB](https://aws.amazon.com/documentdb/resources/).
Jika ada fitur yang tidak didukung yang Anda ingin kami bangun, beri tahu kami dengan mengirimkan email dengan accountID Anda, fitur yang diminta, dan kasus penggunaan ke [tim layanan Amazon DocumentDB](mailto:documentdb-feature-request@amazon.com).
+ [Perintah basis data](#mongo-apis-database)
+ [Operator kueri dan proyeksi](#mongo-apis-query)
+ [Perbarui operator](#mongo-apis-update)
+ [Geospasial](#mongo-apis-geospatial)
+ [Metode kursor](#mongo-apis-cursor)
+ [Operator pipa agregasi](#mongo-apis-aggregation-pipeline)
+ [Jenis Data](#mongo-apis-data-types)
+ [Indeks](#mongo-apis-indexes)
## Perintah basis data
**Topics**
+ [Perintah administratif](#mongo-apis-dababase-administrative)
+ [Agregasi](#mongo-apis-dababase-aggregation)
+ [Autentikasi](#mongo-apis-dababase-authentication)
+ [Perintah diagnostik](#mongo-apis-dababase-diagnostics)
+ [Operasi kueri dan tulis](#mongo-apis-dababase-query-write)
+ [Perintah manajemen peran](#mongo-apis-database-role-management)
+ [Perintah sesi](#mongo-apis-dababase-sessions)
+ [Manajemen pengguna](#mongo-apis-dababase-user-management)
+ [Perintah sharding](#mongo-apis-dababase-sharding)
### Perintah administratif
| Perintah | 3.6 | 4.0 | 5.0 | 8.0 | Cluster elastis |
| --- | --- | --- | --- | --- | --- |
| Koleksi Terbatas | Tidak | Tidak | Tidak | Tidak | Tidak |
| cloneCollectionAsTertutup | Tidak | Tidak | Tidak | Tidak | Tidak |
| collMod | Sebagian | Sebagian | Sebagian | Sebagian | Sebagian |
| CollMod: expireAfterSeconds | Ya | Ya | Ya | Ya | Ya |
| convertToCapped | Tidak | Tidak | Tidak | Tidak | Tidak |
| copydb | Tidak | Tidak | Tidak | Tidak | Tidak |
| Buat | Ya | Ya | Ya | Ya | Ya |
| createView | Tidak | Tidak | Tidak | Ya | Tidak |
| createIndex | Ya | Ya | Ya | Ya | Ya |
| currentOp | Ya | Ya | Ya | Ya | Ya |
| drop | Ya | Ya | Ya | Ya | Ya |
| dropDatabase | Ya | Ya | Ya | Ya | Ya |
| dropIndexes | Ya | Ya | Ya | Ya | Ya |
| filemd5 | Tidak | Tidak | Tidak | Tidak | Tidak |
| getAuditConfig | Tidak | Ya | Ya | Ya | Tidak |
| killCursors | Ya | Ya | Ya | Ya | Ya |
| killOp | Ya | Ya | Ya | Ya | Ya |
| ListCollection\$1 | Ya | Ya | Ya | Ya | Ya |
| listDatabases | Ya | Ya | Ya | Ya | Ya |
| listIndexes | Ya | Ya | Ya | Ya | Ya |
| reIndex | Tidak | Tidak | Ya | Ya | Tidak |
| renameCollection | Ya | Ya | Ya | Ya | Tidak |
| setAuditConfig | Tidak | Ya | Ya | Ya | Tidak |
\$1 `type` Kunci dalam opsi filter tidak didukung.
### Agregasi
| Perintah | 3.6 | 4.0 | 5.0 | 8.0 | Cluster elastis |
| --- | --- | --- | --- | --- | --- |
| agregasi | Ya | Ya | Ya | Ya | Ya |
| hitungan | Ya | Ya | Ya | Ya | Ya |
| berbeda | Ya | Ya | Ya | Ya | Ya |
| mapReduce | Tidak | Tidak | Tidak | Ya | Tidak |
### Autentikasi
| Perintah | 3.6 | 4.0 | 5.0 | 8.0 | Cluster elastis |
| --- | --- | --- | --- | --- | --- |
| diautentikasi | Ya | Ya | Ya | Ya | Ya |
| logout | Ya | Ya | Ya | Ya | Ya |
### Perintah diagnostik
| Perintah | 3.6 | 4.0 | 5.0 | 8.0 | Cluster elastis |
| --- | --- | --- | --- | --- | --- |
| buildInfo | Ya | Ya | Ya | Ya | Ya |
| collStats | Ya | Ya | Ya | Ya | Ya |
| connPoolStats | Tidak | Tidak | Tidak | Tidak | Tidak |
| connectionStatus | Ya | Ya | Ya | Ya | Ya |
| dataSize | Ya | Ya | Ya | Ya | Ya |
| dbHash | Tidak | Tidak | Tidak | Tidak | Tidak |
| dbStats | Ya | Ya | Ya | Ya | Ya |
| jelaskan | Ya | Ya | Ya | Ya | Ya |
| jelaskan: executionStats | Ya | Ya | Ya | Ya | Ya |
| fitur | Tidak | Tidak | Tidak | Tidak | Tidak |
| hostInfo | Ya | Ya | Ya | Ya | Ya |
| listCommands | Ya | Ya | Ya | Ya | Ya |
| profiler | [Ya](https://docs.aws.amazon.com//documentdb/latest/developerguide/profiling.html) | [Ya](https://docs.aws.amazon.com//documentdb/latest/developerguide/profiling.html) | [Ya](https://docs.aws.amazon.com//documentdb/latest/developerguide/profiling.html) | [Ya](https://docs.aws.amazon.com//documentdb/latest/developerguide/profiling.html) | Tidak |
| serverStatus | Ya | Ya | Ya | Ya | Ya |
| atas | Ya | Ya | Ya | Ya | Ya |
### Operasi kueri dan tulis
| Perintah | 3.6 | 4.0 | 5.0 | 8.0 | Cluster elastis |
| --- | --- | --- | --- | --- | --- |
| Mengelola aliran | [Ya](https://docs.aws.amazon.com//documentdb/latest/developerguide/change_streams.html) | [Ya](https://docs.aws.amazon.com//documentdb/latest/developerguide/change_streams.html) | [Ya](https://docs.aws.amazon.com//documentdb/latest/developerguide/change_streams.html) | [Ya](https://docs.aws.amazon.com//documentdb/latest/developerguide/change_streams.html) | Tidak |
| hapus | Ya | Ya | Ya | Ya | Ya |
| cari | Ya | Ya | Ya | Ya | Ya |
| findAndModify | Ya | Ya | Ya | Ya | Ya |
| getLastError | Tidak | Tidak | Tidak | Tidak | Tidak |
| getMore | Ya | Ya | Ya | Ya | Ya |
| getPrevError | Tidak | Tidak | Tidak | Tidak | Tidak |
| GridFS | Ya | Ya | Ya | Ya | Tidak |
| sisipkan | Ya | Ya | Ya | Ya | Ya |
| parallelCollectionScan | Tidak | Tidak | Tidak | Tidak | Tidak |
| resetError | Tidak | Tidak | Tidak | Tidak | Tidak |
| perbarui | Ya | Ya | Ya | Ya | Ya |
| ReplaceOne | Ya | Ya | Ya | Ya | Ya |
### Perintah manajemen peran
| Perintah | 3.6 | 4.0 | 5.0 | 8.0 | Cluster elastis |
| --- | --- | --- | --- | --- | --- |
| createRole | Ya | Ya | Ya | Ya | Tidak |
| dropAllRolesFromDatabase | Ya | Ya | Ya | Ya | Tidak |
| dropRole | Ya | Ya | Ya | Ya | Tidak |
| grantRolesToPeran | Ya | Ya | Ya | Ya | Tidak |
| revokeRolesFromPeran | Ya | Ya | Ya | Ya | Tidak |
| revokePrivilegesFromPeran | Ya | Ya | Ya | Ya | Tidak |
| rolesInfo | Ya | Ya | Ya | Ya | Tidak |
| updateRole | Ya | Ya | Ya | Ya | Tidak |
### Perintah sesi
| Perintah | 3.6 | 4.0 | 5.0 | 8.0 | Cluster elastis |
| --- | --- | --- | --- | --- | --- |
| abortTransaction | Tidak | Ya | Ya | Ya | Tidak |
| commitTransaction | Tidak | Ya | Ya | Ya | Tidak |
| endSessions | Tidak | Tidak | Tidak | Tidak | Tidak |
| killAllSessions | Tidak | Ya | Ya | Ya | Tidak |
| killAllSessionsByPattern | Tidak | Tidak | Tidak | Tidak | Tidak |
| killSessions | Tidak | Ya | Ya | Ya | Tidak |
| refreshsessions | Tidak | Tidak | Tidak | Tidak | Tidak |
| startSession | Tidak | Ya | Ya | Ya | Tidak |
### Manajemen pengguna
| Perintah | 3.6 | 4.0 | 5.0 | 8.0 | Cluster elastis |
| --- | --- | --- | --- | --- | --- |
| createUser | Ya | Ya | Ya | Ya | Ya |
| dropAllUsersFromDatabase | Ya | Ya | Ya | Ya | Ya |
| dropUser | Ya | Ya | Ya | Ya | Ya |
| grantRolesToPengguna | Ya | Ya | Ya | Ya | Ya |
| revokeRolesFromPengguna | Ya | Ya | Ya | Ya | Ya |
| updateUser | Ya | Ya | Ya | Ya | Ya |
| UsersInfo | Ya | Ya | Ya | Ya | Ya |
### Perintah sharding
| Perintah | Cluster elastis |
| --- | --- |
| abortReshardCollection | Tidak |
| AddsHard | Tidak |
| addShardToZona | Tidak |
| balancerCollectionStatus | Tidak |
| BalancerStart | Tidak |
| BalancerStatus | Tidak |
| BalancerSTOP | Tidak |
| checkShardingIndex | Tidak |
| clearJumboFlag | Tidak |
| cleanupOrphaned | Tidak |
| cleanupReshardCollection | Tidak |
| commitReshardCollection | Tidak |
| Aktifkan Sharding | Ya |
| flushRouterConfig | Tidak |
| getShardMap | Tidak |
| getShardVersion | Tidak |
| ISDBgrid | Tidak |
| ListShards | Tidak |
| MedianKey | Tidak |
| MoveChunk | Tidak |
| MovePrimary | Tidak |
| MergeChunks | Tidak |
| refineCollectionShardKunci | Tidak |
| MenghapusHard | Tidak |
| removeShardFromZona | Tidak |
| ResHardCollection | Tidak |
| setAllowMigrations | Tidak |
| setShardVersion | Tidak |
| ShardCollection | Ya |
| ShardingState | Tidak |
| terbelah | Tidak |
| SplitVector | Tidak |
| UnsetSharding | Tidak |
| updateZoneKeyRentang | Tidak |
## Operator kueri dan proyeksi
**Topics**
+ [Operator Array](#mongo-apis-query-array-operators)
+ [Operator Bitwise](#mongo-apis-query-bitwise-operators)
+ [Operator komentar](#mongo-apis-query-comment-operator)
+ [Operator perbandingan](#mongo-apis-query-comparison-operators)
+ [Operator elemen](#mongo-apis-query-element-operators)
+ [Operator kueri evaluasi](#mongo-apis-query-evaluation-operators)
+ [Operator logis](#mongo-apis-query-logical-operators)
+ [Operator proyeksi](#mongo-apis-projection-operators)
### Operator Array
| Perintah | 3.6 | 4.0 | 5.0 | 8.0 | Cluster elastis |
| --- | --- | --- | --- | --- | --- |
| [\$1 semua](all.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1elemMatch](elemMatch.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1size](size-query.md) | Ya | Ya | Ya | Ya | Ya |
### Operator Bitwise
| Perintah | 3.6 | 4.0 | 5.0 | 8.0 | Cluster elastis |
| --- | --- | --- | --- | --- | --- |
| [\$1bitsAllSet](bitsAllSet.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1bitsAnySet](bitsAnySet.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1bitsAllClear](bitsAllClear.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1bitsAnyClear](bitsAnyClear.md) | Ya | Ya | Ya | Ya | Ya |
### Operator komentar
| Perintah | 3.6 | 4.0 | 5.0 | 8.0 | Cluster elastis |
| --- | --- | --- | --- | --- | --- |
| [\$1comment](comment.md) | Ya | Ya | Ya | Ya | Ya |
### Operator perbandingan
| Perintah | 3.6 | 4.0 | 5.0 | 8.0 | Cluster elastis |
| --- | --- | --- | --- | --- | --- |
| [\$1eq](eq.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1gt](gt.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1gte](gte.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1in](in.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1lt](lt.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1lte](lte.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1ne](ne.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1nin](nin.md) | Ya | Ya | Ya | Ya | Ya |
### Operator elemen
| Perintah | 3.6 | 4.0 | 5.0 | 8.0 | Cluster elastis |
| --- | --- | --- | --- | --- | --- |
| [\$1exists](exists.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1type](type.md) | Ya | Ya | Ya | Ya | Ya |
### Operator kueri evaluasi
| Perintah | 3.6 | 4.0 | 5.0 | 8.0 | Cluster elastis |
| --- | --- | --- | --- | --- | --- |
| [\$1expr](expr.md) | Tidak | Ya | Ya | Ya | Tidak |
| [\$1jsonSchema](jsonSchema.md) | Tidak | Ya | Ya | Ya | Tidak |
| [\$1mod](mod-query.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1regex](regex.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1text](text.md) | Tidak | Tidak | Ya | Ya | Tidak |
| \$1where | Tidak | Tidak | Tidak | Tidak | Tidak |
### Operator logis
| Perintah | 3.6 | 4.0 | 5.0 | 8.0 | Cluster elastis |
| --- | --- | --- | --- | --- | --- |
| [\$1and](and.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1nor](nor.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1not](not.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1or](or.md) | Ya | Ya | Ya | Ya | Ya |
### Operator proyeksi
| Perintah | 3.6 | 4.0 | 5.0 | 8.0 | Cluster elastis |
| --- | --- | --- | --- | --- | --- |
| [\$1](dollar-projection.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1elemMatch](elemMatch.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1meta](meta.md) | Tidak | Tidak | Ya | Ya | Tidak |
| [\$1slice](slice-projection.md) | Ya | Ya | Ya | Ya | Ya |
## Perbarui operator
**Topics**
+ [Operator array](#mongo-apis-update-array)
+ [Operator Bitwise](#mongo-apis-update-bitwise)
+ [Operator lapangan](#mongo-apis-update-field)
+ [Perbarui pengubah](#mongo-apis-update-modifiers)
### Operator array
| Perintah | 3.6 | 4.0 | 5.0 | 8.0 | Cluster elastis |
| --- | --- | --- | --- | --- | --- |
| [\$1](dollar-update.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1[]](dollarBrackets-update.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1[]](dollarIdentifier-update.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1addToSet](addToSet.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1 pop](pop.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1 PullAll](pullAll.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1 tarik](pull.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1 dorong](push.md) | Ya | Ya | Ya | Ya | Ya |
### Operator Bitwise
| Perintah | 3.6 | 4.0 | 5.0 | 8.0 | Cluster elastis |
| --- | --- | --- | --- | --- | --- |
| [\$1 bit](bit.md) | Ya | Ya | Ya | Ya | Ya |
### Operator lapangan
| Operator | 3.6 | 4.0 | 5.0 | 8.0 | Cluster elastis |
| --- | --- | --- | --- | --- | --- |
| [\$1CurrentDate](currentDate.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1 inc](inc.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1max](max-update.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1min](min-update.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1 mul](mul.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1 ganti nama](rename.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1set](set-update.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1setOnInsert](setOnInsert.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1unset](unset-update.md) | Ya | Ya | Ya | Ya | Ya |
### Perbarui pengubah
| Operator | 3.6 | 4.0 | 5.0 | 8.0 | Cluster elastis |
| --- | --- | --- | --- | --- | --- |
| [\$1 masing-masing](each.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1 posisi](position.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1slice](slice-update.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1sort](sort-update.md) | Ya | Ya | Ya | Ya | Ya |
## Geospasial
### Penentu geometri
| Pemilih Kueri | 3.6 | 4.0 | 5.0 | 8.0 | Cluster elastis |
| --- | --- | --- | --- | --- | --- |
| \$1box | Tidak | Tidak | Tidak | Tidak | Tidak |
| \$1center | Tidak | Tidak | Tidak | Tidak | Tidak |
| \$1centerSphere | Tidak | Tidak | Tidak | Tidak | Tidak |
| [\$1geometry](geometry.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1maxDistance](maxDistance.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1minDistance](minDistance.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1nearSphere](nearSphere.md) | Ya | Ya | Ya | Ya | Ya |
| \$1polygon | Tidak | Tidak | Tidak | Tidak | Tidak |
| \$1uniqueDocs | Tidak | Tidak | Tidak | Tidak | Tidak |
### Penyeleksi kueri
| Perintah | 3.6 | 4.0 | 5.0 | 8.0 | Cluster elastis |
| --- | --- | --- | --- | --- | --- |
| [\$1geointersects](geoIntersects.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1geowithin](geoWithin.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1near](near.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1nearSphere](nearSphere.md) | Ya | Ya | Ya | Ya | Ya |
| \$1polygon | Tidak | Tidak | Tidak | Tidak | Tidak |
| \$1uniqueDocs | Tidak | Tidak | Tidak | Tidak | Tidak |
## Metode kursor
| Perintah | 3.6 | 4.0 | 5.0 | 8.0 | Cluster elastis |
| --- | --- | --- | --- | --- | --- |
| cursor.batchsize () | Ya | Ya | Ya | Ya | Ya |
| cursor.close () | Ya | Ya | Ya | Ya | Ya |
| cursor.collation() | Tidak | Tidak | Tidak | Ya | Tidak |
| cursor.comment () | Ya | Ya | Ya | Ya | Ya |
| cursor.count () | Ya | Ya | Ya | Ya | Ya |
| cursor.explain () | Ya | Ya | Ya | Ya | Tidak |
| cursor.foreach () | Ya | Ya | Ya | Ya | Ya |
| cursor.hasNext () | Ya | Ya | Ya | Ya | Ya |
| cursor.hint () | Ya | Ya | Ya | Ya | Ya\$1 |
| cursor.isClosed () | Ya | Ya | Ya | Ya | Ya |
| cursor.isExhausted () | Ya | Ya | Ya | Ya | Tidak |
| cursor.itcount () | Ya | Ya | Ya | Ya | Tidak |
| cursor.limit () | Ya | Ya | Ya | Ya | Tidak |
| cursor.map () | Ya | Ya | Ya | Ya | Tidak |
| cursor.max () | Tidak | Tidak | Tidak | Tidak | Tidak |
| cursor.maxScan () | Ya | Ya | Ya | Ya | Tidak |
| cursor.maxTimes () | Ya | Ya | Ya | Ya | Tidak |
| cursor.min () | Tidak | Tidak | Tidak | Tidak | Tidak |
| cursor.next () | Ya | Ya | Ya | Ya | Ya |
| kursor. noCursorTimeout() | Tidak | Tidak | Tidak | Tidak | Tidak |
| kursor. objsLeftInBatch () | Ya | Ya | Ya | Ya | Tidak |
| cursor.pretty () | Ya | Ya | Ya | Ya | Tidak |
| cursor.readconcern () | Ya | Ya | Ya | Ya | Tidak |
| cursor.readPref () | Ya | Ya | Ya | Ya | Tidak |
| cursor.returnKey () | Tidak | Tidak | Tidak | Tidak | Tidak |
| kursor. showRecordId() | Tidak | Tidak | Tidak | Tidak | Tidak |
| cursor.size () | Ya | Ya | Ya | Ya | Tidak |
| cursor.skip () | Ya | Ya | Ya | Ya | Tidak |
| cursor.sort () | Ya | Ya | Ya | Ya | Tidak |
| cursor.tailable () | Tidak | Tidak | Tidak | Tidak | Tidak |
| cursor.toArray () | Ya | Ya | Ya | Ya | Tidak |
\$1 Indeks `hint` didukung dengan ekspresi indeks. Misalnya, `db.foo.find().hint({x:1})`.
## Operator pipa agregasi
**Topics**
+ [Ekspresi akumulator](#mongo-apis-aggregation-pipeline-accumulator-expressions)
+ [Operator aritmatika](#mongo-apis-aggregation-pipeline-arithmetic)
+ [Operator array](#mongo-apis-aggregation-pipeline-array)
+ [Operator Boolean](#mongo-apis-aggregation-pipeline-boolean)
+ [Operator perbandingan](#mongo-apis-aggregation-pipeline-comparison)
+ [Operator ekspresi bersyarat](#mongo-apis-aggregation-pipeline-conditional)
+ [Operator tipe data](#mongo-apis-aggregation-pipeline-data-type)
+ [Operator ukuran data](#mongo-apis-aggregation-pipeline-data-size)
+ [Operator tanggal](#mongo-apis-aggregation-pipeline-date)
+ [Operator literal](#mongo-apis-aggregation-pipeline-literal)
+ [Gabungkan operator](#mongo-apis-aggregation-pipeline-merge)
+ [Operator alami](#mongo-apis-aggregation-pipeline-natural)
+ [Tetapkan operator](#mongo-apis-aggregation-pipeline-set)
+ [Operator panggung](#mongo-apis-aggregation-pipeline-stage)
+ [Operator String](#mongo-apis-aggregation-pipeline-string)
+ [Variabel sistem](#mongo-apis-aggregation-pipeline-system-variables)
+ [Operator pencarian teks](#mongo-apis-aggregation-pipeline-text-search)
+ [Jenis operator konversi](#mongo-apis-aggregation-pipeline-type)
+ [Operator variabel](#mongo-apis-aggregation-pipeline-variable)
+ [Operator lain-lain](#mongo-apis-aggregation-pipeline-misc)
### Ekspresi akumulator
| Ekspresi | 3.6 | 4.0 | 5.0 | 8.0 | Cluster elastis |
| --- | --- | --- | --- | --- | --- |
| \$1 akumulator | - | - | Tidak | Tidak | Tidak |
| [\$1addToSet](addToSet-aggregation.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1avg](avg.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1count](count.md) | - | - | Tidak | Tidak | Tidak |
| \$1 KovariancePOP | Tidak | Tidak | Tidak | Tidak | Tidak |
| \$1 kovarianceSamp | Tidak | Tidak | Tidak | Tidak | Tidak |
| \$1 DenseRank | Tidak | Tidak | Tidak | Tidak | Tidak |
| \$1 turunan | Tidak | Tidak | Tidak | Tidak | Tidak |
| \$1DocumentNumber | Tidak | Tidak | Tidak | Tidak | Tidak |
| \$1expMovingAvg | Tidak | Tidak | Tidak | Tidak | Tidak |
| [\$1first](first.md) | Ya | Ya | Ya | Ya | Ya |
| \$1 integral | Tidak | Tidak | Tidak | Tidak | Tidak |
| [\$1last](last.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1max](max.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1min](min.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1push](push-aggregation.md) | Ya | Ya | Ya | Ya | Ya |
| \$1 peringkat | Tidak | Tidak | Tidak | Tidak | Tidak |
| \$1 shift | Tidak | Tidak | Tidak | Tidak | Tidak |
| \$1stdDevPop | Tidak | Tidak | Tidak | Tidak | Tidak |
| \$1stdDevSamp | Tidak | Tidak | Tidak | Tidak | Tidak |
| [\$1sum](sum.md) | Ya | Ya | Ya | Ya | Ya |
### Operator aritmatika
| Perintah | 3.6 | 4.0 | 5.0 | 8.0 | Cluster elastis |
| --- | --- | --- | --- | --- | --- |
| [\$1abs](abs.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1add](add.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1ceil](ceil.md) | Tidak | Ya | Ya | Ya | Ya |
| [\$1divide](divide.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1exp](exp.md) | Tidak | Ya | Ya | Ya | Ya |
| [\$1floor](floor.md) | Tidak | Ya | Ya | Ya | Ya |
| [\$1In](ln.md) | Tidak | Ya | Ya | Ya | Ya |
| [\$1log](log.md) | Tidak | Ya | Ya | Ya | Ya |
| [\$1log10](log10.md) | Tidak | Ya | Ya | Ya | Ya |
| [\$1mod](mod.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1multiply](multiply.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1pow](pow.md) | Tidak | Tidak | Tidak | Ya | Tidak |
| \$1 bulat | - | - | Tidak | Tidak | Tidak |
| [\$1sqrt](sqrt.md) | Tidak | Ya | Ya | Ya | Ya |
| [\$1subtract](subtract.md) | Ya | Ya | Ya | Ya | Ya |
| \$1trunc | Tidak | Tidak | Tidak | Tidak | Tidak |
### Operator array
| Perintah | 3.6 | 4.0 | 5.0 | 8.0 | Cluster elastis |
| --- | --- | --- | --- | --- | --- |
| [\$1arrayElemAt](arrayElemAt.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1arrayToObject](arrayToObject.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1concatArrays](concatArrays.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1filter](filter.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1first](first.md) | - | - | Ya | Ya | Tidak |
| [\$1in](in-aggregation.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1indexOfArray](indexOfArray.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1isArray](isArray.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1last](last.md) | - | - | Ya | Ya | Tidak |
| [\$1objectToArray](objectToArray.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1range](range.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1reverseArray](reverseArray.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1reduce](reduce.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1size](size.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1slice](slice.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1zip](zip.md) | Ya | Ya | Ya | Ya | Ya |
### Operator Boolean
| Perintah | 3.6 | 4.0 | 5.0 | 8.0 | Cluster elastis |
| --- | --- | --- | --- | --- | --- |
| [\$1and](and-aggregation.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1not](not-aggregation.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1or](or-aggregation.md) | Ya | Ya | Ya | Ya | Ya |
### Operator perbandingan
| Perintah | 3.6 | 4.0 | 5.0 | 8.0 | Cluster elastis |
| --- | --- | --- | --- | --- | --- |
| [\$1cmp](cmp.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1eq](eq-aggregation.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1gt](gt-aggregation.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1gte](gte-aggregation.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1lt](lt-aggregation.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1lte](lte-aggregation.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1ne](ne-aggregation.md) | Ya | Ya | Ya | Ya | Ya |
### Operator ekspresi bersyarat
| Perintah | 3.6 | 4.0 | 5.0 | 8.0 | Cluster elastis |
| --- | --- | --- | --- | --- | --- |
| [\$1cond](cond.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1ifNull](ifNull.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1switch](switch.md) | Tidak | Ya | Ya | Ya | Tidak |
### Operator tipe data
| Perintah | 3.6 | 4.0 | 5.0 | 8.0 | Cluster elastis |
| --- | --- | --- | --- | --- | --- |
| [\$1type](type-aggregation.md) | Ya | Ya | Ya | Ya | Ya |
### Operator ukuran data
| Perintah | 3.6 | 4.0 | 5.0 | 8.0 | Cluster elastis |
| --- | --- | --- | --- | --- | --- |
| \$1 BinarySize | - | - | Tidak | Tidak | Tidak |
| \$1 BSONSize | - | - | Tidak | Tidak | Tidak |
### Operator tanggal
| Perintah | 3.6 | 4.0 | 5.0 | 8.0 | Cluster elastis |
| --- | --- | --- | --- | --- | --- |
| [\$1 DateAdd](dateAdd.md) | Tidak | Tidak | Ya | Ya | Ya |
| [\$1 DateDiff](dateDiff.md) | - | - | Ya | Ya | Tidak |
| \$1dateFromParts | Tidak | Tidak | Tidak | Tidak | Tidak |
| [\$1dateFromString](dateFromString.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1 DateSubtract](dateSubtract.md) | Tidak | Tidak | Ya | Ya | Ya |
| \$1dateToParts | Tidak | Tidak | Tidak | Tidak | Tidak |
| [\$1dateToString](dateToString.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1 DateTrunc](dateTrunc.md) | - | - | Tidak | Ya | Tidak |
| [\$1dayOfMonth](dayOfMonth.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1dayOfWeek](dayOfWeek.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1dayOfYear](dayOfYear.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1hour](hour.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1 isoDayOf Minggu](isoDayOfWeek.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1isoWeek](isoWeek.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1isoWeekYear](isoWeekYear.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1millisecond](millisecond.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1minute](minute.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1month](month.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1second](second.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1week](week.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1year](year.md) | Ya | Ya | Ya | Ya | Ya |
### Operator literal
| Perintah | 3.6 | 4.0 | 5.0 | 8.0 | Cluster elastis |
| --- | --- | --- | --- | --- | --- |
| [\$1literal](literal.md) | Ya | Ya | Ya | Ya | Ya |
### Gabungkan operator
| Perintah | 3.6 | 4.0 | 5.0 | 8.0 | Cluster elastis |
| --- | --- | --- | --- | --- | --- |
| [\$1mergeObjects](mergeObjects.md) | Ya | Ya | Ya | Ya | Ya |
### Operator alami
| Perintah | 3.6 | 4.0 | 5.0 | 8.0 | Cluster elastis |
| --- | --- | --- | --- | --- | --- |
| [\$1natural](natural.md) | Ya | Ya | Ya | Ya | Ya |
### Tetapkan operator
| Perintah | 3.6 | 4.0 | 5.0 | 8.0 | Cluster elastis |
| --- | --- | --- | --- | --- | --- |
| [\$1allElementsTrue](allElementsTrue.md) | Tidak | Ya | Ya | Ya | Ya |
| [\$1anyElementTrue](anyElementTrue.md) | Tidak | Ya | Ya | Ya | Ya |
| [\$1setDifference](setDifference.md) | Tidak | Ya | Ya | Ya | Ya |
| [\$1setEquals](setEquals.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1setIntersection](setIntersection.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1setIsSubset](setIsSubset.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1setUnion](setUnion.md) | Ya | Ya | Ya | Ya | Ya |
| \$1setWindowFields | Tidak | Tidak | Tidak | Tidak | Tidak |
### Operator panggung
| Perintah | 3.6 | 4.0 | 5.0 | 8.0 | Cluster elastis |
| --- | --- | --- | --- | --- | --- |
| [\$1addFields](addFields.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1bucket](bucket.md) | Tidak | Tidak | Tidak | Ya | Tidak |
| \$1bucketAuto | Tidak | Tidak | Tidak | Tidak |
| [\$1 ChangeStream](changeStream.md) | Ya | Ya | Ya | Ya | Tidak |
| [\$1collStats](collStats.md) | Tidak | Ya | Ya | Ya | Tidak |
| [\$1count](count.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1currentOp](currentOp.md) | Ya | Ya | Ya | Ya | Ya |
| \$1facet | Tidak | Tidak | Tidak | Tidak | Tidak |
| [\$1geoNear](geoNear.md) | Ya | Ya | Ya | Ya | Ya |
| \$1graphLookup | Tidak | Tidak | Tidak | Tidak | Tidak |
| [\$1group](group.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1indexStats](indexStats.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1limit](limit.md) | Ya | Ya | Ya | Ya | Ya |
| \$1listLocalSessions | Tidak | Tidak | Tidak | Tidak | Tidak |
| \$1listSessions | Tidak | Tidak | Tidak | Tidak | Tidak |
| [\$1lookup](lookup.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1match](match.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1 bergabung](merge.md) | - | - | Tidak | Ya | Tidak |
| [\$1out](out.md) | Ya | Ya | Ya | Ya | Tidak |
| \$1planCacheStats | - | - | Tidak | Tidak | Tidak |
| [\$1project](project.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1redact](redact.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1replaceRoot](replaceRoot.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1sample](sample.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1set](set-stage.md) | - | - | Tidak | Ya | Tidak |
| \$1setWindowFields | - | - | Tidak | Tidak | Tidak |
| [\$1skip](skip.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1sort](sort.md) | Ya | Ya | Ya | Ya | Ya |
| \$1sortByCount | Tidak | Tidak | Tidak | Tidak | Tidak |
| \$1unionDengan | - | - | Tidak | Tidak | Tidak |
| [\$1unset](unset-stage.md) | - | - | Tidak | Ya | Tidak |
| [\$1unwind](unwind.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1 GantiDengan](replaceWith.md) | Tidak | Tidak | Tidak | Ya | Tidak |
| [\$1 VectorSearch](vectorSearch.md) | Tidak | Tidak | Tidak | Ya | Tidak |
### Operator String
| Perintah | 3.6 | 4.0 | 5.0 | 8.0 | Cluster elastis |
| --- | --- | --- | --- | --- | --- |
| [\$1concat](concat.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1indexOfBytes](indexOfBytes.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1indexOfCP](indexOfCP.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1ltrim](ltrim.md) | Tidak | Ya | Ya | Ya | Tidak |
| [\$1RegexFind](regexFind.md) | - | - | Ya | Ya | Tidak |
| [\$1regexFindAll](regexFindAll.md) | - | - | Ya | Ya | Tidak |
| [\$1RegexMatch](regexMatch.md) | - | - | Ya | Ya | Tidak |
| [\$1 GantiSemua](replaceAll.md) | - | - | Ya | Ya | Tidak |
| [\$1 GantiSatu](replaceOne.md) | - | - | Ya | Ya | Tidak |
| [\$1rtrim](rtrim.md) | Tidak | Ya | Ya | Ya | Tidak |
| [\$1split](split.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1strcasecmp](strcasecmp.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1strLenBytes](strLenBytes.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1strLenCP](strLenCP.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1substr](substr.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1substrBytes](substrBytes.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1substrCP](substrCP.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1toLower](toLower.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1toUpper](toUpper.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1trim](trim.md) | Tidak | Ya | Ya | Ya | Tidak |
### Variabel sistem
| Perintah | 3.6 | 4.0 | 5.0 | 8.0 | Cluster elastis |
| --- | --- | --- | --- | --- | --- |
| \$1\$1CURRENT | Tidak | Tidak | Tidak | Tidak | Tidak |
| [\$1\$1DESCEND](DESCEND.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1\$1KEEP](KEEP.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1\$1PRUNE](PRUNE.md) | Ya | Ya | Ya | Ya | Ya |
| \$1\$1REMOVE | Tidak | Tidak | Tidak | Tidak | Tidak |
| [\$1 AKAR](ROOT.md) | Ya | Ya | Ya | Ya | Ya |
### Operator pencarian teks
| Perintah | 3.6 | 4.0 | 5.0 | 8.0 | Cluster elastis |
| --- | --- | --- | --- | --- | --- |
| [\$1meta](meta-aggregation.md) | Tidak | Tidak | Ya | Ya | Tidak |
| [\$1 pencarian](search.md) | Tidak | Tidak | Ya | Ya | Tidak |
### Jenis operator konversi
| Perintah | 3.6 | 4.0 | 5.0 | 8.0 | Cluster elastis |
| --- | --- | --- | --- | --- | --- |
| [\$1convert](convert.md) | Tidak | Ya | Ya | Ya | Ya |
| \$1 isNumber | - | - | Tidak | Tidak | Tidak |
| [\$1toBool](toBool.md) | Tidak | Ya | Ya | Ya | Ya |
| [\$1toDate](toDate.md) | Tidak | Ya | Ya | Ya | Ya |
| [\$1toDecimal](toDecimal.md) | Tidak | Ya | Ya | Ya | Ya |
| [\$1toDouble](toDouble.md) | Tidak | Ya | Ya | Ya | Ya |
| [\$1toInt](toInt.md) | Tidak | Ya | Ya | Ya | Ya |
| [\$1toLong](toLong.md) | Tidak | Ya | Ya | Ya | Ya |
| [\$1toObjectId](toObjectId.md) | Tidak | Ya | Ya | Ya | Ya |
| [\$1toString](toString.md) | Tidak | Ya | Ya | Ya | Ya |
### Operator variabel
| Perintah | 3.6 | 4.0 | 5.0 | 8.0 | Cluster elastis |
| --- | --- | --- | --- | --- | --- |
| [\$1let](let.md) | Ya | Ya | Ya | Ya | Ya |
| [\$1map](map.md) | Ya | Ya | Ya | Ya | Ya |
### Operator lain-lain
| Perintah | 3.6 | 4.0 | 5.0 | 8.0 | Cluster elastis |
| --- | --- | --- | --- | --- | --- |
| \$1 GetField | - | - | Tidak | Tidak | Tidak |
| [\$1 rand](rand.md) | - | - | Tidak | Ya | Tidak |
| \$1 Samplerate | - | - | Tidak | Tidak | Tidak |
## Jenis Data
| Perintah | 3.6 | 4.0 | 5.0 | 8.0 | Cluster elastis |
| --- | --- | --- | --- | --- | --- |
| 32-bit Integer (int) | Ya | Ya | Ya | Ya | Ya |
| 64-bit Integer (long) | Ya | Ya | Ya | Ya | Ya |
| Array | Ya | Ya | Ya | Ya | Ya |
| Data Biner | Ya | Ya | Ya | Ya | Ya |
| Boolean | Ya | Ya | Ya | Ya | Ya |
| Date | Ya | Ya | Ya | Ya | Ya |
| DBPointer | Tidak | Tidak | Tidak | Tidak | Tidak |
| DBRefs | Tidak | Tidak | Tidak | Tidak | Tidak |
| Decimal128 | Ya | Ya | Ya | Ya | Ya |
| Ganda | Ya | Ya | Ya | Ya | Ya |
| JavaScript | Tidak | Tidak | Tidak | Tidak | Tidak |
| JavaScript(dengan ruang lingkup) | Tidak | Tidak | Tidak | Tidak | Tidak |
| MaxKey | Ya | Ya | Ya | Ya | Ya |
| MinKey | Ya | Ya | Ya | Ya | Ya |
| Null | Ya | Ya | Ya | Ya | Ya |
| Objek | Ya | Ya | Ya | Ya | Ya |
| ObjectId | Ya | Ya | Ya | Ya | Ya |
| Ekspresi reguler | Ya | Ya | Ya | Ya | Ya |
| Tali | Ya | Ya | Ya | Ya | Ya |
| Simbol | Tidak | Tidak | Tidak | Tidak | Tidak |
| Stempel waktu | Ya | Ya | Ya | Ya | Ya |
| Tidak terdefinisi | Tidak | Tidak | Tidak | Tidak | Tidak |
## Indeks dan properti indeks
**Topics**
+ [Indeks](#mongo-apis-indexes)
+ [Properti indeks](#mongo-apis-index-properties)
### Indeks
| Perintah | 3.6 | 4.0 | 5.0 | 8.0 | Cluster elastis |
| --- | --- | --- | --- | --- | --- |
| 2dsphere | Ya | Ya | Ya | Ya | Ya |
| Indeks 2d | Tidak | Tidak | Tidak | Tidak | Tidak |
| Indeks Gabungan | Ya | Ya | Ya | Ya | Ya |
| Indeks hashed | Tidak | Tidak | Tidak | Tidak | Tidak |
| Indeks Multikey | Ya | Ya | Ya | Ya | Ya |
| Indeks Bidang Tunggal | Ya | Ya | Ya | Ya | Ya |
| Indeks Teks | Tidak | Tidak | Ya | Ya | Tidak |
| Wildcard | Tidak | Tidak | Tidak | Tidak | Tidak |
### Properti indeks
| Perintah | 3.6 | 4.0 | 5.0 | 8.0 | Cluster elastis |
| --- | --- | --- | --- | --- | --- |
| Latar Belakang | Ya | Ya | Ya | Ya | Ya |
| Tidak peka huruf besar/kecil | Tidak | Tidak | Tidak | Ya | Tidak |
| Tersembunyi | Tidak | Tidak | Tidak | Tidak | Tidak |
| Sebagian | Tidak | Tidak | Ya | Ya | Tidak |
| Jarang | Ya | Ya | Ya | Ya | Ya |
| Teks | Tidak | Tidak | Ya | Ya | Tidak |
| TTL | Ya | Ya | Ya | Ya | Ya |
| Unik | Ya | Ya | Ya | Ya | Ya |
| vektor | Tidak | Tidak | Ya | Ya | Tidak |
Untuk informasi rinci tentang operator MongoDB tertentu, lihat topik berikut:
+ [Operator pipa agregasi](mongo-apis-aggregation-pipeline-operators.md)
+ [Geospasial](mongo-apis-geospatial-operators.md)
+ [Operator proyeksi](#mongo-apis-projection-operators)
+ [Perbarui operator](mongo-apis-update-operators.md)
# Operator pipa agregasi
Bagian ini memberikan informasi terperinci tentang operator pipeline agregasi yang didukung oleh Amazon DocumentDB.
**Topics**
+ [\$1\$1DESCEND](DESCEND.md)
+ [\$1\$1KEEP](KEEP.md)
+ [\$1\$1PRUNE](PRUNE.md)
+ [\$1 AKAR](ROOT.md)
+ [\$1abs](abs.md)
+ [\$1add](add.md)
+ [\$1addToSet](addToSet-aggregation.md)
+ [\$1addFields](addFields.md)
+ [\$1allElementsTrue](allElementsTrue.md)
+ [\$1and](and-aggregation.md)
+ [\$1anyElementTrue](anyElementTrue.md)
+ [\$1arrayElemAt](arrayElemAt.md)
+ [\$1arrayToObject](arrayToObject.md)
+ [\$1avg](avg.md)
+ [\$1bucket](bucket.md)
+ [\$1ceil](ceil.md)
+ [\$1 ChangeStream](changeStream.md)
+ [\$1cmp](cmp.md)
+ [\$1collStats](collStats.md)
+ [\$1concat](concat.md)
+ [\$1concatArrays](concatArrays.md)
+ [\$1cond](cond.md)
+ [\$1convert](convert.md)
+ [\$1count](count.md)
+ [\$1currentOp](currentOp.md)
+ [\$1 DateAdd](dateAdd.md)
+ [\$1 DateDiff](dateDiff.md)
+ [\$1dateFromString](dateFromString.md)
+ [\$1 DateSubtract](dateSubtract.md)
+ [\$1dateToString](dateToString.md)
+ [\$1 DateTrunc](dateTrunc.md)
+ [\$1dayOfMonth](dayOfMonth.md)
+ [\$1dayOfWeek](dayOfWeek.md)
+ [\$1dayOfYear](dayOfYear.md)
+ [\$1divide](divide.md)
+ [\$1eq](eq-aggregation.md)
+ [\$1exp](exp.md)
+ [\$1filter](filter.md)
+ [\$1first](first.md)
+ [\$1floor](floor.md)
+ [\$1geoNear](geoNear.md)
+ [\$1group](group.md)
+ [\$1gt](gt-aggregation.md)
+ [\$1gte](gte-aggregation.md)
+ [\$1hour](hour.md)
+ [\$1ifNull](ifNull.md)
+ [\$1in](in-aggregation.md)
+ [\$1indexOfArray](indexOfArray.md)
+ [\$1indexOfBytes](indexOfBytes.md)
+ [\$1indexOfCP](indexOfCP.md)
+ [\$1indexStats](indexStats.md)
+ [\$1isArray](isArray.md)
+ [\$1 isoDayOf Minggu](isoDayOfWeek.md)
+ [\$1isoWeek](isoWeek.md)
+ [\$1isoWeekYear](isoWeekYear.md)
+ [\$1last](last.md)
+ [\$1let](let.md)
+ [\$1limit](limit.md)
+ [\$1literal](literal.md)
+ [\$1In](ln.md)
+ [\$1log](log.md)
+ [\$1log10](log10.md)
+ [\$1lt](lt-aggregation.md)
+ [\$1lte](lte-aggregation.md)
+ [\$1lookup](lookup.md)
+ [\$1ltrim](ltrim.md)
+ [\$1map](map.md)
+ [\$1match](match.md)
+ [\$1max](max.md)
+ [\$1meta](meta-aggregation.md)
+ [\$1 bergabung](merge.md)
+ [\$1mergeObjects](mergeObjects.md)
+ [\$1millisecond](millisecond.md)
+ [\$1min](min.md)
+ [\$1minute](minute.md)
+ [\$1mod](mod.md)
+ [\$1month](month.md)
+ [\$1multiply](multiply.md)
+ [\$1natural](natural.md)
+ [\$1ne](ne-aggregation.md)
+ [\$1not](not-aggregation.md)
+ [\$1objectToArray](objectToArray.md)
+ [\$1or](or-aggregation.md)
+ [\$1out](out.md)
+ [\$1pow](pow.md)
+ [\$1push](push-aggregation.md)
+ [\$1project](project.md)
+ [\$1 rand](rand.md)
+ [\$1range](range.md)
+ [\$1redact](redact.md)
+ [\$1reduce](reduce.md)
+ [\$1RegexFind](regexFind.md)
+ [\$1regexFindAll](regexFindAll.md)
+ [\$1RegexMatch](regexMatch.md)
+ [\$1 GantiSemua](replaceAll.md)
+ [\$1 GantiSatu](replaceOne.md)
+ [\$1replaceRoot](replaceRoot.md)
+ [\$1 GantiDengan](replaceWith.md)
+ [\$1reverseArray](reverseArray.md)
+ [\$1rtrim](rtrim.md)
+ [\$1sample](sample.md)
+ [\$1 pencarian](search.md)
+ [\$1second](second.md)
+ [\$1set](set-stage.md)
+ [\$1setDifference](setDifference.md)
+ [\$1setEquals](setEquals.md)
+ [\$1setIntersection](setIntersection.md)
+ [\$1setIsSubset](setIsSubset.md)
+ [\$1setUnion](setUnion.md)
+ [\$1skip](skip.md)
+ [\$1slice](slice.md)
+ [\$1size](size.md)
+ [\$1sort](sort.md)
+ [\$1split](split.md)
+ [\$1sqrt](sqrt.md)
+ [\$1strLenBytes](strLenBytes.md)
+ [\$1strLenCP](strLenCP.md)
+ [\$1strcasecmp](strcasecmp.md)
+ [\$1substr](substr.md)
+ [\$1substrBytes](substrBytes.md)
+ [\$1substrCP](substrCP.md)
+ [\$1subtract](subtract.md)
+ [\$1sum](sum.md)
+ [\$1switch](switch.md)
+ [\$1toBool](toBool.md)
+ [\$1toDate](toDate.md)
+ [\$1toDecimal](toDecimal.md)
+ [\$1toDouble](toDouble.md)
+ [\$1toInt](toInt.md)
+ [\$1toLong](toLong.md)
+ [\$1toLower](toLower.md)
+ [\$1toObjectId](toObjectId.md)
+ [\$1toString](toString.md)
+ [\$1toUpper](toUpper.md)
+ [\$1trim](trim.md)
+ [\$1type](type-aggregation.md)
+ [\$1unset](unset-stage.md)
+ [\$1unwind](unwind.md)
+ [\$1 VectorSearch](vectorSearch.md)
+ [\$1week](week.md)
+ [\$1year](year.md)
+ [\$1zip](zip.md)
# \$1\$1DESCEND
`$$DESCEND`Operator di Amazon DocumentDB adalah operator array posisi khusus yang digunakan dalam tahap pipeline. `$redact` Ini menginstruksikan pipa agregasi untuk turun ke dokumen saat ini dan memproses semua bidang, terlepas dari tingkat sarangnya.
Ketika `$redact` tahap bertemu dengan `$$DESCEND` operator, itu akan membuat semua bidang dalam dokumen saat ini terlihat dan memprosesnya lebih jauh ke bawah pipa. Ini berguna ketika Anda ingin menyunting atau memangkas bidang tertentu secara selektif berdasarkan suatu kondisi, sambil mempertahankan struktur dokumen.
**Parameter**
Tidak ada.
## Contoh (MongoDB Shell)
Dalam contoh ini, kita akan menggunakan `$redact` panggung dengan `$$DESCEND` operator untuk secara selektif menampilkan dokumen di mana `code` bidang sama dengan “Reg”.
**Buat dokumen sampel**
```
db.patient.insertMany([
{ "_id": 1, "code": "Emp", "patient": "John Doe", "DOB": "1/1/1980", "Hospital": "Main" },
{ "_id": 2, "code": "Reg", "patient": "Jane Doe", "DOB": "3/27/1989", "Hospital": "Cherry Hill" },
{ "_id": 3, "code": "Emp", "patient": "Bob Smith", "DOB": "6/15/1975", "Hospital": "Downtown" }
]);
```
**Contoh kueri**
```
db.patient.aggregate([
{ $redact: {
$cond: {
if: { $eq: ["Reg", "$code"] },
then: "$$DESCEND",
else: "$$PRUNE"
}
}}
]);
```
**Keluaran**
```
{
"_id": 2,
"code": "Reg",
"patient": "Jane Doe",
"DOB": "3/27/1989",
"Hospital": "Cherry Hill"
}
```
## Contoh kode
Untuk melihat contoh kode untuk menggunakan `$$DESCEND` perintah, pilih tab untuk bahasa yang ingin Anda gunakan:
------
#### [ Node.js ]
```
const { MongoClient } = require('mongodb');
async function redactPatients() {
const client = await MongoClient.connect('mongodb://:@:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false');
const db = client.db('test');
const collection = db.collection('patient');
const result = await collection.aggregate([
{ $redact: {
$cond: {
if: { $eq: ["Reg", "$code"] },
then: "$$DESCEND",
else: "$$PRUNE"
}
}}
]).toArray();
console.log(result);
client.close();
}
redactPatients();
```
------
#### [ Python ]
```
from pymongo import MongoClient
def redact_patients():
client = MongoClient('mongodb://:@:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false')
db = client.test
collection = db.patient
result = list(collection.aggregate([
{ "$redact": {
"$cond": {
"if": { "$eq": ["Reg", "$code"] },
"then": "$$DESCEND",
"else": "$$PRUNE"
}
}}
]))
print(result)
client.close()
redact_patients()
```
------
# \$1\$1KEEP
Variabel `$$KEEP` sistem digunakan dengan `$redact` tahapan dalam pipa agregasi untuk menjaga dokumen atau bidang saat ini tidak berubah dan memasukkannya ke dalam output.
**Parameter**
Tidak ada
## Contoh (MongoDB Shell)
Contoh berikut menunjukkan penggunaan `$$KEEP` dalam pipeline agregasi Amazon DocumentDB. Dokumen hanya disimpan jika akses sama dengan “publik”, jika tidak maka akan dihapus.
**Buat dokumen sampel**
```
db.articles.insertMany([
{ title: "Article A", access: "public", content: "Visible content" },
{ title: "Article B", access: "private", content: "Hidden content" }
]);
```
**Contoh kueri**
```
db.articles.aggregate([
{
$redact: {
$cond: [
{ $eq: ["$access", "public"] },
"$$KEEP",
"$$PRUNE"
]
}
}
]);
```
**Keluaran**
```
[
{
"_id" : ObjectId("..."),
"title" : "Article A",
"access" : "public",
"content" : "Visible content"
}
]
```
## Contoh kode
Untuk melihat contoh kode untuk menggunakan `$$KEEP` perintah, pilih tab untuk bahasa yang ingin Anda gunakan:
------
#### [ Node.js ]
```
const { MongoClient } = require('mongodb');
async function run() {
const client = new MongoClient(
'mongodb://:@:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0'
);
try {
await client.connect();
const db = client.db('test');
const articles = db.collection('articles');
const pipeline = [
{
$redact: {
$cond: [
{ $eq: ["$access", "public"] },
"$$KEEP",
"$$PRUNE"
]
}
}
];
const results = await articles.aggregate(pipeline).toArray();
console.log(results);
} finally {
await client.close();
}
}
run().catch(console.error);
```
------
#### [ Python ]
```
from pymongo import MongoClient
client = MongoClient(
"mongodb://:@:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0"
)
db = client.test
articles = db.articles
pipeline = [
{
"$redact": {
"$cond": [
{"$eq": ["$access", "public"]},
"$$KEEP",
"$$PRUNE"
]
}
}
]
results = list(articles.aggregate(pipeline))
print(results)
client.close()
```
------
# \$1\$1PRUNE
Variabel `$$PRUNE` sistem digunakan dengan `$redact` tahapan dalam pipa agregasi untuk mengecualikan dokumen atau level dokumen tertanam dari hasil. Ketika suatu kondisi dievaluasi`$$PRUNE`, dokumen atau subdokumen saat ini dihapus dari output. Ini biasanya digunakan dengan `$$DESCEND` (untuk menyimpan dan melintasi dokumen) atau `$$KEEP` (untuk menyimpan dokumen di semua tingkatan).
**Parameter**
Tidak ada. Variabel `$$PRUNE` sistem digunakan tanpa parameter apa pun dan harus digunakan dengan`$redact`.
## Contoh (MongoDB Shell)
Contoh berikut menunjukkan cara menggunakan `$$PRUNE` dengan `$redact` untuk mengecualikan pengguna berusia di atas 30 tahun dari hasil.
**Buat dokumen sampel**
```
db.users.insert([
{ _id:1, name: "Carlos Salazar", age: 35, address: { street: "123 Main St", city: "Anytown", state: "CA" } },
{ _id:2, name: "Saanvi Sarkar", age: 28, address: { street: "456 Oak Rd", city: "Someplace", state: "NY" } },
{ _id:3, name: "Li Juan", age: 42, address: { street: "789 Pine Ave", city: "Springfield", state: "TX" } }
])
```
**Contoh kueri**
```
db.users.aggregate([
{
$redact: {
$cond: {
if: { $gt: ["$age", 30] },
then: "$$PRUNE",
else: "$$DESCEND"
}
}
}
])
```
**Keluaran**
```
[
{
"_id": 2,
"name": "Saanvi Sarkar",
"age": 28,
"address": {
"street": "456 Oak Rd",
"city": "Someplace",
"state": "NY"
}
}
]
```
## Contoh kode
Untuk melihat contoh kode untuk menggunakan `$$PRUNE` perintah, pilih tab untuk bahasa yang ingin Anda gunakan:
------
#### [ Node.js ]
```
const { MongoClient } = require('mongodb');
const client = new MongoClient('mongodb://:@:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false');
async function main() {
await client.connect();
const db = client.db('test');
const users = db.collection('users');
const result = await users.aggregate([
{
$redact: {
$cond: {
if: { $gt: ["$age", 30] },
then: "$$PRUNE",
else: "$$DESCEND"
}
}
}
]).toArray();
console.log(result);
await client.close();
}
main();
```
------
#### [ Python ]
```
from pymongo import MongoClient
client = MongoClient('mongodb://:@:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false')
db = client['test']
users = db['users']
result = list(users.aggregate([
{
'$redact': {
'$cond': {
'if': { '$gt': ['$age', 30] },
'then': '$$PRUNE',
'else': '$$DESCEND'
}
}
}
]))
print(result)
client.close()
```
------
# \$1 AKAR
`$ROOT`Operator di Amazon DocumentDB digunakan untuk mereferensikan seluruh dokumen input dalam pipeline agregasi. Ini memungkinkan Anda untuk mengakses dan memanipulasi dokumen lengkap, termasuk semua bidang dan struktur bersarangnya.
**Parameter**
Tidak ada
## Contoh (MongoDB Shell)
Contoh ini menunjukkan penggunaan `$ROOT` untuk membuat log audit yang menangkap dokumen asli lengkap bersama dengan metadata tentang kapan diproses.
**Buat dokumen sampel**
```
db.orders.insertMany([
{
_id: 1,
orderId: "ORD-2024-001",
customer: "María García",
email: "maría@example.com",
items: [
{ product: "Laptop", quantity: 1, price: 1299.99 }
],
totalAmount: 1299.99
},
{
_id: 2,
orderId: "ORD-2024-002",
customer: "Arnav Desai",
email: "arnav@example.com",
items: [
{ product: "Mouse", quantity: 2, price: 29.99 },
{ product: "Keyboard", quantity: 1, price: 89.99 }
],
totalAmount: 149.97
}
]);
```
**Contoh kueri**
```
db.orders.aggregate([
{
$project: {
processedAt: new Date(),
originalDocument: "$$ROOT",
summary: {
$concat: [
"Order ",
"$orderId",
" for ",
"$customer",
" - Total: $",
{ $toString: "$totalAmount" }
]
}
}
}
]);
```
**Keluaran**
```
[
{
_id: 1,
processedAt: ISODate('2025-11-24T20:43:51.492Z'),
originalDocument: {
_id: 1,
orderId: 'ORD-2024-001',
customer: 'María García',
email: 'maría@example.com',
items: [ { product: 'Laptop', quantity: 1, price: 1299.99 } ],
totalAmount: 1299.99
},
summary: 'Order ORD-2024-001 for María García - Total: $1299.99'
},
{
_id: 2,
processedAt: ISODate('2025-11-24T20:43:51.492Z'),
originalDocument: {
_id: 2,
orderId: 'ORD-2024-002',
customer: 'Arnav Desai',
email: 'arnav@example.com',
items: [
{ product: 'Mouse', quantity: 2, price: 29.99 },
{ product: 'Keyboard', quantity: 1, price: 89.99 }
],
totalAmount: 149.97
},
summary: 'Order ORD-2024-002 for Arnav Desai - Total: $149.97'
}
]
```
## Contoh kode
Untuk melihat contoh kode untuk menggunakan `$ROOT` perintah, pilih tab untuk bahasa yang ingin Anda gunakan:
------
#### [ Node.js ]
```
const { MongoClient } = require('mongodb');
async function createAuditLog() {
const client = await MongoClient.connect('mongodb://:@:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false');
const db = client.db('test');
const orders = db.collection('orders');
const result = await orders.aggregate([
{
$project: {
processedAt: new Date(),
originalDocument: "$$ROOT",
summary: {
$concat: [
"Order ",
"$orderId",
" for ",
"$customer",
" - Total: $",
{ $toString: "$totalAmount" }
]
}
}
}
]).toArray();
console.log(result);
await client.close();
}
createAuditLog();
```
------
#### [ Python ]
```
from pymongo import MongoClient
from datetime import datetime
def create_audit_log():
client = MongoClient('mongodb://username:password@docdb-cluster.cluster-123456789.us-east-1.docdb.amazonaws.com:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false')
db = client['test']
collection = db['orders']
result = list(collection.aggregate([
{
'$project': {
'processedAt': datetime.now(),
'originalDocument': '$$ROOT',
'summary': {
'$concat': [
"Order ",
"$orderId",
" for ",
"$customer",
" - Total: $",
{ '$toString': "$totalAmount" }
]
}
}
}
]))
print(result)
client.close()
create_audit_log()
```
------
# \$1abs
`$abs`Operator di Amazon DocumentDB mengembalikan nilai absolut dari suatu angka. Ini dapat digunakan dalam pipa agregasi untuk melakukan operasi matematika pada bidang numerik.
**Parameter**
+ `number`: Ekspresi numerik yang nilai absolutnya akan dikembalikan.
## Contoh (MongoDB Shell)
Contoh ini menunjukkan penggunaan `$abs` operator untuk menemukan nilai absolut dari bidang numerik.
**Buat dokumen sampel**
```
db.numbers.insertMany([
{ "_id": 1, "value": -5 },
{ "_id": 2, "value": 10 },
{ "_id": 3, "value": -3.14 },
{ "_id": 4, "value": 0 }
]);
```
**Contoh kueri**
```
db.numbers.aggregate([
{ $project: {
"_id": 1,
"absolute_value": { $abs: "$value" }
}}
]);
```
**Keluaran**
```
[
{ "_id": 1, "absolute_value": 5 },
{ "_id": 2, "absolute_value": 10 },
{ "_id": 3, "absolute_value": 3.14 },
{ "_id": 4, "absolute_value": 0 }
]
```
## Contoh kode
Untuk melihat contoh kode untuk menggunakan `$abs` perintah, pilih tab untuk bahasa yang ingin Anda gunakan:
------
#### [ Node.js ]
```
const { MongoClient } = require('mongodb');
async function main() {
const client = await MongoClient.connect('mongodb://:@:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false');
const db = client.db('test');
const collection = db.collection('numbers');
const result = await collection.aggregate([
{ $project: {
"_id": 1,
"absolute_value": { $abs: "$value" }
}}
]).toArray();
console.log(result);
await client.close();
}
main();
```
------
#### [ Python ]
```
from pymongo import MongoClient
def main():
client = MongoClient('mongodb://:@:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false')
db = client['test']
collection = db['numbers']
result = list(collection.aggregate([
{ '$project': {
"_id": 1,
"absolute_value": { "$abs": "$value" }
}}
]))
print(result)
client.close()
if __name__ == "__main__":
main()
```
------
# \$1add
`$add`Operator di Amazon DocumentDB digunakan untuk menambahkan angka atau tanggal bersama-sama. Ini dapat digunakan untuk melakukan operasi aritmatika pada bidang numerik atau untuk melakukan aritmatika tanggal dengan menambahkan sejumlah unit waktu ke bidang tanggal.
**Parameter**
+ `expression1`: Nomor atau tanggal pertama untuk ditambahkan.
+ `expression2`: Angka atau tanggal kedua untuk ditambahkan.
+ `expression3`: (opsional) Nomor atau tanggal tambahan untuk ditambahkan.
## Contoh (MongoDB Shell)
Contoh berikut menunjukkan bagaimana menggunakan `$add` operator untuk menambahkan dua angka bersama-sama.
**Buat dokumen sampel**
```
db.numbers.insertMany([
{ _id: 1, a: 5, b: 3 },
{ _id: 2, a: 10, b: 7 },
{ _id: 3, a: 2, b: 8 }
]);
```
**Contoh kueri**
```
db.numbers.aggregate([
{ $project: {
_id: 1,
sum: { $add: ["$a", "$b"] }
}}
])
```
**Keluaran**
```
[
{ "_id" : 1, "sum" : 8 },
{ "_id" : 2, "sum" : 17 },
{ "_id" : 3, "sum" : 10 }
]
```
Dalam contoh ini, `$add` operator digunakan untuk menambahkan nilai `a` dan `b` bidang untuk setiap dokumen dan menyimpan hasilnya di `sum` bidang.
## Contoh kode
Untuk melihat contoh kode untuk menggunakan `$add` perintah, pilih tab untuk bahasa yang ingin Anda gunakan:
------
#### [ Node.js ]
```
const { MongoClient } = require('mongodb');
async function example() {
const client = await MongoClient.connect('mongodb://:@:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false');
const db = client.db('test');
const collection = db.collection('numbers');
const result = await collection.aggregate([
{ $project: {
_id: 1,
sum: { $add: ['$a', '$b'] }
}}
]).toArray();
console.log(result);
client.close();
}
example();
```
------
#### [ Python ]
```
from pymongo import MongoClient
client = MongoClient('mongodb://:@:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false')
db = client['test']
collection = db['numbers']
result = list(collection.aggregate([
{ '$project': {
'_id': 1,
'sum': { '$add': ['$a', '$b'] }
}}
]))
print(result)
client.close()
```
------
# \$1addToSet
Operator `$addToSet` agregasi mengembalikan array nilai unik dari ekspresi tertentu untuk setiap grup. Ini digunakan dalam `$group` tahap untuk mengakumulasi nilai yang berbeda, secara otomatis menghilangkan duplikat.
**Parameter**
+ `expression`: Ekspresi untuk mengevaluasi setiap dokumen dalam grup.
## Contoh (MongoDB Shell)
Contoh berikut menunjukkan penggunaan `$addToSet` operator untuk mengumpulkan kota-kota unik di mana pesanan ditempatkan untuk setiap pelanggan.
**Buat dokumen sampel**
```
db.orders.insertMany([
{ _id: 1, customer: "Alice", city: "Seattle", amount: 100 },
{ _id: 2, customer: "Alice", city: "Portland", amount: 150 },
{ _id: 3, customer: "Bob", city: "Seattle", amount: 200 },
{ _id: 4, customer: "Alice", city: "Seattle", amount: 75 },
{ _id: 5, customer: "Bob", city: "Boston", amount: 300 }
]);
```
**Contoh kueri**
```
db.orders.aggregate([
{
$group: {
_id: "$customer",
cities: { $addToSet: "$city" }
}
}
]);
```
**Keluaran**
```
[
{ _id: 'Bob', cities: [ 'Seattle', 'Boston' ] },
{ _id: 'Alice', cities: [ 'Seattle', 'Portland' ] }
]
```
## Contoh kode
Untuk melihat contoh kode untuk menggunakan operator `$addToSet` agregasi, pilih tab untuk bahasa yang ingin Anda gunakan:
------
#### [ Node.js ]
```
const { MongoClient } = require('mongodb');
async function example() {
const client = await MongoClient.connect('mongodb://:@:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false');
const db = client.db('test');
const collection = db.collection('orders');
const result = await collection.aggregate([
{
$group: {
_id: "$customer",
cities: { $addToSet: "$city" }
}
}
]).toArray();
console.log(result);
await client.close();
}
example();
```
------
#### [ Python ]
```
from pymongo import MongoClient
def example():
client = MongoClient('mongodb://:@:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false')
db = client['test']
collection = db['orders']
result = list(collection.aggregate([
{
'$group': {
'_id': '$customer',
'cities': { '$addToSet': '$city' }
}
}
]))
print(result)
client.close()
example()
```
------
# \$1addFields
`$addFields`Tahap dalam pipeline agregasi Amazon DocumentDB memungkinkan Anda menambahkan bidang terkomputasi baru ke dokumen. Ini dapat berguna untuk menambahkan data yang diturunkan atau diubah ke dokumen.
**Parameter**
+ `newField`: Nama bidang baru untuk ditambahkan.
+ `expression`: Ekspresi yang menyelesaikan nilai bidang baru.
## Contoh (MongoDB Shell)
Contoh berikut menunjukkan bagaimana menggunakan `$addFields` untuk menambahkan bidang baru `TotalInventory` yang menghitung total inventaris berdasarkan `Inventory.OnHand` dan `Inventory.OrderQnty` bidang.
**Buat dokumen sampel**
```
db.example.insertMany([
{
"Item": "Spray Paint",
"Colors": ["Black", "Red", "Green", "Blue"],
"Inventory": {
"OnHand": 47,
"MinOnHand": 50,
"OrderQnty": 36
},
"UnitPrice": 3.99
},
{
"Item": "Ruler",
"Colors": ["Red", "Green", "Blue", "Clear", "Yellow"],
"Inventory": {
"OnHand": 47,
"MinOnHand": 40
},
"UnitPrice": 0.89
}
]);
```
**Contoh kueri**
```
db.example.aggregate([
{
$addFields: {
TotalInventory: { $add: ["$Inventory.OnHand", "$Inventory.OrderQnty"] }
}
}
])
```
**Keluaran**
```
[
{
"_id" : ObjectId("5bedafbcf65ff161707de24f"),
"Item" : "Ruler",
"Colors" : [ "Red", "Green", "Blue", "Clear", "Yellow" ],
"Inventory" : {
"OnHand" : 47,
"MinOnHand" : 40
},
"UnitPrice" : 0.89,
"TotalInventory" : 47
},
{
"_id" : ObjectId("5bedafbcf65ff161707de250"),
"Item" : "Spray Paint",
"Colors" : [ "Black", "Red", "Green", "Blue" ],
"Inventory" : {
"OnHand" : 47,
"MinOnHand" : 50,
"OrderQnty" : 36
},
"UnitPrice" : 3.99,
"TotalInventory" : 83
}
]
```
## Contoh kode
Untuk melihat contoh kode untuk menggunakan `$addFields` perintah, pilih tab untuk bahasa yang ingin Anda gunakan:
------
#### [ Node.js ]
```
const { MongoClient } = require('mongodb');
const client = await MongoClient.connect('mongodb://:@:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false');
const db = client.db('test');
const collection = db.collection('example');
const result = await collection.aggregate([
{
$addFields: {
TotalInventory: { $add: ['$Inventory.OnHand', '$Inventory.OrderQnty'] }
}
}
]).toArray();
console.log(result);
await client.close();
```
------
#### [ Python ]
```
from pymongo import MongoClient
client = MongoClient('mongodb://:@:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false')
db = client['test']
collection = db['example']
result = list(collection.aggregate([
{
'$addFields': {
'TotalInventory': { '$add': ['$Inventory.OnHand', '$Inventory.OrderQnty'] }
}
}
]))
print(result)
client.close()
```
------
# \$1allElementsTrue
Baru dari versi 4.0
`$allElementsTrue`Operator digunakan untuk memeriksa apakah semua elemen dalam array mengevaluasi ke nilai sebenarnya.
**Parameter**
+ `expression`: Ekspresi yang mengevaluasi array.
## Contoh (MongoDB Shell)
Contoh berikut menunjukkan penggunaan `$allElementsTrue` untuk memeriksa apakah semua elemen dalam array benar.
**Buat dokumen sampel**
```
db.collection.insert([
{ "name": "John", "scores": [100, 90, 80] },
{ "name": "Jane", "scores": [80, 85, 0] },
{ "name": "Bob", "scores": [90, 95, null] }
])
```
**Contoh kueri**
```
db.collection.find({
"scores": { "$allElementsTrue": [{ "$gt": 0 }] }
})
```
**Keluaran**
```
[
{ "_id" : ObjectId("..."), "name" : "John", "scores" : [ 100, 90, 80 ] },
{ "_id" : ObjectId("..."), "name" : "Bob", "scores" : [ 90, 95, null ] }
]
```
Dalam contoh ini, query memeriksa apakah semua elemen dalam `scores` array lebih besar dari 0. Dokumen dengan `"name": "Jane"` dikecualikan karena `scores` array berisi 0, yang merupakan nilai palsu.
## Contoh kode
Untuk melihat contoh kode untuk menggunakan `$allElementsTrue` perintah, pilih tab untuk bahasa yang ingin Anda gunakan:
------
#### [ Node.js ]
```
const { MongoClient } = require('mongodb');
async function example() {
const client = await MongoClient.connect('mongodb://:@:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false');
const db = client.db('test');
const collection = db.collection('collection');
const result = await collection.find({
"scores": { "$allElementsTrue": [{ "$gt": 0 }] }
}).toArray();
console.log(result);
await client.close();
}
example();
```
------
#### [ Python ]
```
from pymongo import MongoClient
def example():
client = MongoClient('mongodb://:@:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false')
db = client['test']
collection = db['collection']
result = list(collection.find({
"scores": {"$allElementsTrue": [{"$gt": 0}]}
}))
print(result)
client.close()
example()
```
------
# \$1and
Operator `$and` agregasi mengevaluasi beberapa ekspresi dan mengembalikan `true` hanya jika semua ekspresi mengevaluasi. `true` Jika ada ekspresi`false`, ia kembali`false`.
**Parameter**
+ `expressions`: Sebuah array ekspresi untuk mengevaluasi.
## Contoh (MongoDB Shell)
Contoh berikut menunjukkan penggunaan `$and` operator untuk memeriksa apakah produk memenuhi beberapa kriteria.
**Buat dokumen sampel**
```
db.products.insertMany([
{ _id: 1, name: "Laptop", price: 1200, inStock: true },
{ _id: 2, name: "Mouse", price: 25, inStock: false },
{ _id: 3, name: "Keyboard", price: 75, inStock: true }
]);
```
**Contoh kueri**
```
db.products.aggregate([
{
$project: {
name: 1,
price: 1,
inStock: 1,
affordable: {
$and: [
{ $lt: ["$price", 100] },
{ $eq: ["$inStock", true] }
]
}
}
}
]);
```
**Keluaran**
```
[
{ _id: 1, name: 'Laptop', price: 1200, inStock: true, affordable: false },
{ _id: 2, name: 'Mouse', price: 25, inStock: false, affordable: false },
{ _id: 3, name: 'Keyboard', price: 75, inStock: true, affordable: true }
]
```
## Contoh kode
Untuk melihat contoh kode untuk menggunakan operator `$and` agregasi, pilih tab untuk bahasa yang ingin Anda gunakan:
------
#### [ Node.js ]
```
const { MongoClient } = require('mongodb');
async function example() {
const client = await MongoClient.connect('mongodb://:@:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false');
const db = client.db('test');
const collection = db.collection('products');
const result = await collection.aggregate([
{
$project: {
name: 1,
price: 1,
inStock: 1,
affordable: {
$and: [
{ $lt: ["$price", 100] },
{ $eq: ["$inStock", true] }
]
}
}
}
]).toArray();
console.log(result);
await client.close();
}
example();
```
------
#### [ Python ]
```
from pymongo import MongoClient
def example():
client = MongoClient('mongodb://:@:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false')
db = client['test']
collection = db['products']
result = list(collection.aggregate([
{
'$project': {
'name': 1,
'price': 1,
'inStock': 1,
'affordable': {
'$and': [
{ '$lt': ['$price', 100] },
{ '$eq': ['$inStock', True] }
]
}
}
}
]))
print(result)
client.close()
example()
```
------
# \$1anyElementTrue
Baru dari versi 4.0
`$anyElementTrue`Operator digunakan untuk menentukan apakah ada elemen dalam array yang benar.
**Parameter**
+ `field`: Bidang array untuk mengevaluasi.
## Contoh (MongoDB Shell)
Contoh berikut menunjukkan penggunaan `$anyElementTrue` untuk memeriksa apakah ada elemen dalam array benar.
**Buat dokumen sampel**
```
db.grades.insertMany([
{ _id: 1, student: 'Tim', scores: [false, false, null] },
{ _id: 2, student: 'Bob', scores: [false, 0, false] },
{ _id: 3, student: 'Ivy', scores: [false, true, 0] }
])
```
**Contoh kueri**
```
db.grades.aggregate([
{
$project: {
student: 1,
isAnyTrue: { $anyElementTrue: ["$scores"] },
_id: 0
}
}
])
```
**Keluaran**
```
[
{ student: 'Tim', isAnyTrue: false },
{ student: 'Bob', isAnyTrue: false },
{ student: 'Ivy', isAnyTrue: true }
]
```
## Contoh kode
Untuk melihat contoh kode untuk menggunakan `$anyElementTrue` perintah, pilih tab untuk bahasa yang ingin Anda gunakan:
------
#### [ Node.js ]
```
const { MongoClient } = require('mongodb');
async function example() {
const client = await MongoClient.connect('mongodb://:@:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false');
const db = client.db('test');
const collection = db.collection('grades');
const result = await collection.aggregate([
{
$project: {
student: 1,
isAnyTrue: { $anyElementTrue: ["$scores"] },
_id: 0
}
}
]).toArray();
console.log(result);
await client.close();
}
example();
```
------
#### [ Python ]
```
from pymongo import MongoClient
def example():
client = MongoClient('mongodb://:@:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false')
db = client['test']
collection = db['grades']
result = list(collection.aggregate([
{
"$project": {
"student": 1,
"isAnyTrue": { "$anyElementTrue": ["$scores"] },
"_id": 0
}
}
]))
print(result)
client.close()
example()
```
------
# \$1arrayElemAt
`$arrayElemAt`Operator di Amazon DocumentDB memungkinkan Anda untuk mengambil elemen dari array dengan posisi indeksnya. Ini sangat berguna ketika Anda perlu mengakses elemen tertentu dalam bidang array dalam dokumen Anda.
**Parameter**
+ `array`: Array input dari mana elemen akan diambil.
+ `index`: Posisi indeks berbasis nol dari elemen untuk mengambil. Nilai ini harus berupa bilangan bulat non-negatif.
## Contoh (MongoDB Shell)
Dalam contoh ini, kita akan menunjukkan bagaimana menggunakan `$arrayElemAt` operator untuk mengambil elemen tertentu dari `flight_miles` array dalam `miles` koleksi.
**Buat dokumen sampel**
```
db.miles.insertMany([
{ "_id" : 1, "member_since" : ISODate("1987-01-01T00:00:00Z"), "credit_card" : false, "flight_miles" : [ 1205, 2560, 880 ]},
{ "_id" : 2, "member_since" : ISODate("1982-01-01T00:00:00Z"), "credit_card" : true, "flight_miles" : [ 1205, 2560, 890, 2780 ]},
{ "_id" : 3, "member_since" : ISODate("1999-01-01T00:00:00Z"), "credit_card" : true, "flight_miles" : [ 1205, 880 ]}
]);
```
**Contoh kueri**
```
db.miles.aggregate([
{ $project: {
"_id": 1,
"first_mile": { $arrayElemAt: [ "$flight_miles", 0 ] },
"last_mile": { $arrayElemAt: [ "$flight_miles", -1 ] }
}}
]);
```
**Keluaran**
```
{ "_id" : 1, "first_mile" : 1205, "last_mile" : 880 }
{ "_id" : 2, "first_mile" : 1205, "last_mile" : 2780 }
{ "_id" : 3, "first_mile" : 1205, "last_mile" : 880 }
```
Dalam contoh ini, kita menggunakan `$arrayElemAt` operator untuk mengambil elemen pertama dan terakhir dari `flight_miles` array untuk setiap dokumen.
## Contoh kode
Untuk melihat contoh kode untuk menggunakan `$arrayElemAt` perintah, pilih tab untuk bahasa yang ingin Anda gunakan:
------
#### [ Node.js ]
```
const { MongoClient } = require('mongodb');
async function example() {
const client = await MongoClient.connect('mongodb://:@:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false');
const db = client.db('test');
const collection = db.collection('miles');
const result = await collection.aggregate([
{ $project: {
"_id": 1,
"first_mile": { $arrayElemAt: [ "$flight_miles", 0 ] },
"last_mile": { $arrayElemAt: [ "$flight_miles", -1 ] }
}}
]).toArray();
console.log(result);
client.close();
}
example();
```
------
#### [ Python ]
```
from pymongo import MongoClient
def example():
client = MongoClient('mongodb://:@:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false')
db = client.mydatabase
collection = db.miles
result = list(collection.aggregate([
{ "$project": {
"_id": 1,
"first_mile": { "$arrayElemAt": [ "$flight_miles", 0 ] },
"last_mile": { "$arrayElemAt": [ "$flight_miles", -1 ] }
}}
]))
print(result)
client.close()
example()
```
------
# \$1arrayToObject
`$arrayToObject`Operator di Amazon DocumentDB adalah kebalikan dari operator. `$objectToArray` Dibutuhkan array dokumen pasangan kunci-nilai dan mengubahnya menjadi satu dokumen. Ini sangat berguna ketika Anda perlu mengubah array pasangan kunci-nilai kembali ke objek atau struktur dokumen.
**Parameter**
+ `array expression`: Ekspresi yang menyelesaikan ke array. Elemen array harus dokumen dengan dua bidang: `k` (kunci) dan `v` (nilai).
## Contoh (MongoDB Shell)
Contoh di bawah ini menunjukkan bagaimana menggunakan `$arrayToObject` untuk mengkonversi array pasangan kunci-nilai kembali ke dokumen.
**Buat dokumen sampel**
```
db.videos.insertMany([
{ "_id": 1, "name": "Live Soft", "inventory": { "Des Moines": 1000, "Ames": 500 } },
{ "_id": 2, "name": "Top Pilot", "inventory": { "Mason City": 250, "Des Moines": 1000 } },
{ "_id": 3, "name": "Romancing the Rock", "inventory": { "Mason City": 250, "Ames": 500 } },
{ "_id": 4, "name": "Bravemind", "inventory": { "Mason City": 250, "Des Moines": 1000, "Ames": 500 } }
]);
```
**Contoh kueri**
```
db.videos.aggregate([
{ $project: { name: 1, videos: { $objectToArray: "$inventory" } } },
{ $project: { name: 1, inventory: { $arrayToObject: "$videos" } } }
]);
```
**Keluaran**
```
{ "_id" : 1, "name" : "Live Soft", "inventory" : { "Des Moines" : 1000, "Ames" : 500 } }
{ "_id" : 2, "name" : "Top Pilot", "inventory" : { "Mason City" : 250, "Des Moines" : 1000 } }
{ "_id" : 3, "name" : "Romancing the Rock", "inventory" : { "Mason City" : 250, "Ames" : 500 } }
{ "_id" : 4, "name" : "Bravemind", "inventory" : { "Mason City" : 250, "Des Moines" : 1000, "Ames" : 500 } }
```
Dalam contoh ini, `$objectToArray` operator digunakan untuk mengubah `inventory` objek menjadi array pasangan kunci-nilai. `$arrayToObject`Operator kemudian digunakan untuk mengubah array kembali menjadi dokumen, memulihkan struktur objek asli.
## Contoh kode
Untuk melihat contoh kode untuk menggunakan `$arrayToObject` perintah, pilih tab untuk bahasa yang ingin Anda gunakan:
------
#### [ Node.js ]
```
const { MongoClient } = require('mongodb');
async function example() {
const client = await MongoClient.connect('mongodb://:@:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false');
const db = client.db('test');
const collection = db.collection('videos');
const result = await collection.aggregate([
{ $project: { name: 1, videos: { $objectToArray: '$inventory' } } },
{ $project: { name: 1, inventory: { $arrayToObject: '$videos' } } }
]).toArray();
console.log(result);
await client.close();
}
example();
```
------
#### [ Python ]
```
from pymongo import MongoClient
def example():
client = MongoClient('mongodb://:@:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false')
db = client['test']
collection = db['videos']
result = list(collection.aggregate([
{ '$project': { 'name': 1, 'videos': { '$objectToArray': '$inventory' } } },
{ '$project': { 'name': 1, 'inventory': { '$arrayToObject': '$videos' } } }
]))
print(result)
client.close()
example()
```
------
# \$1avg
Operator `$avg` agregasi di Amazon DocumentDB menghitung nilai rata-rata ekspresi yang ditentukan di seluruh dokumen yang dimasukkan ke panggung. Operator ini berguna untuk menghitung rata-rata bidang numerik atau ekspresi di satu set dokumen.
**Parameter**
+ `expression`: Ekspresi yang digunakan untuk menghitung rata-rata. Ini bisa berupa jalur bidang (misalnya`"$field"`) atau ekspresi (misalnya`{ $multiply: ["$field1", "$field2"] }`).
## Contoh (MongoDB Shell)
Contoh berikut menunjukkan bagaimana menggunakan `$avg` operator untuk menghitung skor rata-rata di satu set dokumen siswa.
**Buat dokumen sampel**
```
db.students.insertMany([
{ name: "John", score: 85 },
{ name: "Jane", score: 92 },
{ name: "Bob", score: 78 },
{ name: "Alice", score: 90 }
]);
```
**Contoh kueri**
```
db.students.aggregate([
{ $group: {
_id: null,
avgScore: { $avg: "$score" }
}}
]);
```
**Keluaran**
```
[
{
"_id": null,
"avgScore": 86.25
}
]
```
## Contoh kode
Untuk melihat contoh kode untuk menggunakan `$avg` perintah, pilih tab untuk bahasa yang ingin Anda gunakan:
------
#### [ Node.js ]
```
const { MongoClient } = require('mongodb');
async function calculateAvgScore() {
const client = await MongoClient.connect('mongodb://:@:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false');
const db = client.db('test');
const result = await db.collection('students').aggregate([
{ $group: {
_id: null,
avgScore: { $avg: '$score' }
}}
]).toArray();
console.log(result);
await client.close();
}
calculateAvgScore();
```
------
#### [ Python ]
```
from pymongo import MongoClient
def calculate_avg_score():
client = MongoClient('mongodb://:@:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false')
db = client.test
result = list(db.students.aggregate([
{ '$group': {
'_id': None,
'avgScore': { '$avg': '$score' }
}}
]))
print(result)
client.close()
calculate_avg_score()
```
------
# \$1bucket
Baru dari versi 8.0
Tidak didukung oleh cluster elastis.
Tahap `$bucket` agregasi di Amazon DocumentDB memungkinkan Anda mengelompokkan dokumen masukan ke dalam bucket berdasarkan ekspresi dan batas bucket yang ditentukan. Ini dapat berguna untuk menganalisis data yang termasuk dalam rentang nilai atau kategori tertentu.
**Parameter**
+ `groupBy`(required): Ekspresi yang menentukan nilai untuk dikelompokkan menurut.
+ `boundaries`(required): Array nilai ganda yang menentukan batas bucket. Dokumen ditugaskan ke ember berdasarkan nilai `groupBy` ekspresi yang termasuk dalam batas-batas yang ditentukan.
+ `default`(opsional): Nilai literal yang merupakan output untuk dokumen yang nilai `groupBy` ekspresinya tidak termasuk dalam batas yang ditentukan.
+ `output`(opsional): Objek yang menentukan informasi yang akan dikeluarkan untuk setiap bucket. Anda dapat menggunakan operator akumulator seperti`$sum`,, `$avg``$min`, dan `$max` untuk menghitung agregasi untuk setiap bucket.
## Contoh (MongoDB Shell)
Contoh berikut menunjukkan bagaimana menggunakan `$bucket` panggung untuk mengelompokkan data penjualan berdasarkan kisaran harga.
**Buat dokumen sampel**
```
db.sales.insertMany([
{ item: "abc", price: 10, quantity: 2, date: new Date("2020-09-01") },
{ item: "def", price: 20, quantity: 1, date: new Date("2020-10-01") },
{ item: "ghi", price: 5, quantity: 3, date: new Date("2020-11-01") },
{ item: "jkl", price: 15, quantity: 2, date: new Date("2020-12-01") },
{ item: "mno", price: 25, quantity: 1, date: new Date("2021-01-01") }
]);
```
**Contoh kueri**
```
db.sales.aggregate([
{
$bucket: {
groupBy: "$price",
boundaries: [0, 10, 20, 30],
default: "Other",
output: {
"count": { $sum: 1 },
"totalQuantity": { $sum: "$quantity" }
}
}
},
{
$sort: { _id: 1 }
}
])
```
**Keluaran**
```
[
{ _id: 0, count: 1, totalQuantity: 3 },
{ _id: 10, count: 2, totalQuantity: 4 },
{ _id: 20, count: 2, totalQuantity: 2 }
]
```
## Contoh kode
Untuk melihat contoh kode untuk menggunakan `$bucket` perintah, pilih tab untuk bahasa yang ingin Anda gunakan:
------
#### [ Node.js ]
```
const { MongoClient } = require('mongodb');
async function example() {
const client = await MongoClient.connect('mongodb://:@:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false');
const db = client.db('test');
const sales = db.collection('sales');
const result = await sales.aggregate([
{
$bucket: {
groupBy: "$price",
boundaries: [0, 10, 20, 30],
default: "Other",
output: {
"count": { $sum: 1 },
"totalQuantity": { $sum: "$quantity" }
}
}
},
{
$sort: { _id: 1 }
}
]).toArray();
console.log(result);
client.close();
}
example();
```
------
#### [ Python ]
```
from pymongo import MongoClient
def example():
client = MongoClient('mongodb://:@:27017/?tls=true&lsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false')
db = client['test']
sales = db['sales']
result = list(sales.aggregate([
{
'$bucket': {
'groupBy': '$price',
'boundaries': [0, 10, 20, 30],
'default': 'Other',
'output': {
'count': {'$sum': 1},
'totalQuantity': {'$sum': '$quantity'}
}
}
},
{
"$sort": { "_id": 1 }
}
]))
print(result)
client.close()
example()
```
------
# \$1ceil
Baru dari versi 4.0
`$ceil`Operator di Amazon DocumentDB, seperti di MongoDB, membulatkan angka ke bilangan bulat terdekat. Ini berguna ketika Anda perlu melakukan operasi matematika pada bidang numerik dan memastikan hasilnya adalah bilangan bulat.
**Parameter**
+ `expression`: Ekspresi numerik untuk dibulatkan.
## Contoh (MongoDB Shell)
Contoh ini menunjukkan bagaimana menggunakan `$ceil` operator untuk mengumpulkan bidang numerik.
**Buat dokumen sampel**
```
db.numbers.insertMany([
{ "_id": 1, "value": 3.14 },
{ "_id": 2, "value": -2.7 },
{ "_id": 3, "value": 0 }
])
```
**Contoh kueri**
```
db.numbers.aggregate([
{ $project: {
"roundedUp": { $ceil: "$value" }
}}
])
```
**Keluaran**
```
{ "_id": 1, "roundedUp": 4 }
{ "_id": 2, "roundedUp": -2 }
{ "_id": 3, "roundedUp": 0 }
```
## Contoh kode
Untuk melihat contoh kode untuk menggunakan `$ceil` perintah, pilih tab untuk bahasa yang ingin Anda gunakan:
------
#### [ Node.js ]
```
const { MongoClient } = require('mongodb');
async function example() {
const client = await MongoClient.connect('mongodb://:@:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false');
const db = client.db('test');
const collection = db.collection('numbers');
const result = await collection.aggregate([
{ $project: {
"roundedUp": { $ceil: "$value" }
}}
]).toArray();
console.log(result);
client.close();
}
example();
```
------
#### [ Python ]
```
from pymongo import MongoClient
def example():
client = MongoClient('mongodb://:@:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false')
db = client.test
collection = db.numbers
result = list(collection.aggregate([
{ '$project': {
"roundedUp": { '$ceil': "$value" }
}}
]))
print(result)
client.close()
example()
```
------
# \$1 ChangeStream
Tidak didukung oleh cluster elastis.
Tahap `$changeStream` agregasi membuka kursor aliran perubahan untuk memantau perubahan real-time ke koleksi. Ia mengembalikan perubahan dokumen peristiwa ketika menyisipkan, memperbarui, mengganti, atau menghapus operasi terjadi.
**Parameter**
+ `fullDocument`: Menentukan apakah akan mengembalikan dokumen lengkap untuk operasi update. Pilihannya adalah `default` atau`updateLookup`.
+ `resumeAfter`: Opsional. Lanjutkan token untuk melanjutkan dari titik tertentu dalam aliran perubahan.
+ `startAtOperationTime`: Opsional. Stempel waktu untuk memulai aliran perubahan dari.
+ `allChangesForCluster`: Opsional. Nilai Boolean. Kapan`true`, perhatikan semua perubahan di seluruh cluster (untuk database admin). Ketika `false` (default), hanya menonton koleksi yang ditentukan.
## Contoh (MongoDB Shell)
Contoh berikut menunjukkan menggunakan `$changeStream` panggung untuk memantau perubahan koleksi.
**Contoh kueri**
```
// Open change stream first
const changeStream = db.inventory.aggregate([
{ $changeStream: { fullDocument: "updateLookup" } }
]);
// In another session, insert a document
db.inventory.insertOne({ _id: 1, item: "Widget", qty: 10 });
// Back in the first session, read the change event
if (changeStream.hasNext()) {
print(tojson(changeStream.next()));
}
```
**Keluaran**
```
{
_id: { _data: '...' },
operationType: 'insert',
clusterTime: Timestamp(1, 1234567890),
fullDocument: { _id: 1, item: 'Widget', qty: 10 },
ns: { db: 'test', coll: 'inventory' },
documentKey: { _id: 1 }
}
```
## Contoh kode
Untuk melihat contoh kode untuk menggunakan tahap `$changeStream` agregasi, pilih tab untuk bahasa yang ingin Anda gunakan:
------
#### [ Node.js ]
```
const { MongoClient } = require('mongodb');
async function example() {
const client = await MongoClient.connect('mongodb://:@:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false');
const db = client.db('test');
const collection = db.collection('inventory');
// Open change stream
const changeStream = collection.watch([]);
changeStream.on('change', (change) => {
console.log('Change detected:', change);
});
// Simulate insert in another operation
setTimeout(async () => {
await collection.insertOne({ _id: 1, item: 'Widget', qty: 10 });
}, 1000);
// Keep connection open to receive changes
// In production, handle cleanup appropriately
}
example();
```
------
#### [ Python ]
```
from pymongo import MongoClient
import threading
import time
def example():
client = MongoClient('mongodb://:@:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false')
db = client['test']
collection = db['inventory']
# Open change stream
change_stream = collection.watch([])
# Insert document in separate thread after delay
def insert_doc():
time.sleep(1)
collection.insert_one({'_id': 1, 'item': 'Widget', 'qty': 10})
threading.Thread(target=insert_doc).start()
# Watch for changes
for change in change_stream:
print('Change detected:', change)
break # Exit after first change
client.close()
example()
```
------
# \$1cmp
`$cmp`Operator di Amazon DocumentDB digunakan untuk membandingkan dua nilai dan mengembalikan nilai integer yang menunjukkan urutan relatifnya. Ini adalah operator perbandingan yang membandingkan dua ekspresi dan mengembalikan nilai integer -1, 0, atau 1, tergantung pada apakah nilai pertama kurang dari, sama dengan, atau lebih besar dari nilai kedua, masing-masing.
**Parameter**
+ `expression1`: Ekspresi pertama untuk membandingkan.
+ `expression2`: Ekspresi kedua untuk membandingkan.
## Contoh (MongoDB Shell)
Contoh berikut menunjukkan penggunaan `$cmp` operator untuk membandingkan dua nilai numerik.
**Buat dokumen sampel**
```
db.collection.insertMany([
{ _id: 1, value1: 10, value2: 20 },
{ _id: 2, value1: 15, value2: 15 },
{ _id: 3, value1: 20, value2: 10 }
]);
```
**Contoh kueri**
```
db.collection.find({
$expr: {
$cmp: ["$value1", "$value2"]
}
})
```
**Keluaran**
```
[
{ "_id" : 1, "value1" : 10, "value2" : 20 },
{ "_id" : 3, "value1" : 20, "value2" : 10 }
]
```
Dalam contoh ini, `$cmp` operator membandingkan `value2` bidang `value1` dan untuk setiap dokumen. Hasilnya adalah:
```
- `$cmp: ["$value1", "$value2"]` returns -1 for the first document (10 < 20), 0 for the second document (15 = 15), and 1 for the third document (20 > 10).
```
## Contoh kode
Untuk melihat contoh kode untuk menggunakan `$cmp` perintah, pilih tab untuk bahasa yang ingin Anda gunakan:
------
#### [ Node.js ]
Berikut adalah contoh penggunaan `$cmp` operator dalam aplikasi Node.js dengan `mongodb` driver:
```
const { MongoClient } = require('mongodb');
const client = new MongoClient('mongodb://:@:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false');
async function main() {
await client.connect();
const db = client.db('test');
const collection = db.collection('mycollection');
// Insert sample documents
await collection.insertMany([
{ _id: 1, value1: 10, value2: 20 },
{ _id: 2, value1: 15, value2: 15 },
{ _id: 3, value1: 20, value2: 10 }
]);
// Query using $cmp operator
const result = await collection.find({
$expr: {
$cmp: ['$value1', '$value2']
}
}).toArray();
console.log(result);
await client.close();
}
main();
```
------
#### [ Python ]
Berikut adalah contoh penggunaan `$cmp` operator dalam aplikasi Python dengan driver: `pymongo`
```
from pymongo import MongoClient
client = MongoClient('mongodb://:@:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false')
db = client['test']
collection = db['mycollection']
# Insert sample documents
collection.insert_many([
{'_id': 1, 'value1': 10, 'value2': 20},
{'_id': 2, 'value1': 15, 'value2': 15},
{'_id': 3, 'value1': 20, 'value2': 10}
])
# Query using $cmp operator
result = list(collection.find({
'$expr': {
'$cmp': ['$value1', '$value2']
}
}))
print(result)
client.close()
```
Output dari contoh Node.js dan Python akan sama dengan contoh MongoDB Shell:
```
[
{ "_id" : 1, "value1" : 10, "value2" : 20 },
{ "_id" : 2, "value1" : 15, "value2" : 15 },
{ "_id" : 3, "value1" : 20, "value2" : 10 }
]
```
------
# \$1collStats
Baru dari versi 4.0
Tahap `$collStats` agregasi di Amazon DocumentDB menyediakan statistik tentang koleksi yang ditentukan, mirip dengan perintah di shell `db.collection.stats()` MongoDB. Tahap ini dapat digunakan untuk mengambil informasi tentang koleksi, seperti jumlah dokumen, ukuran total koleksi, dan berbagai metrik kinerja.
**Parameter**
+ `latencyStats`: (opsional) Dokumen yang menentukan opsi untuk mengumpulkan statistik latensi. Parameter ini tidak didukung di Amazon DocumentDB.
+ `recordStats`: (opsional) Dokumen yang menentukan opsi untuk mengumpulkan statistik catatan. Parameter ini tidak didukung di Amazon DocumentDB.
+ `queryExecStats`: (opsional) Sebuah dokumen yang menentukan pilihan untuk mengumpulkan statistik eksekusi query. Parameter ini tidak didukung di Amazon DocumentDB.
## Contoh (MongoDB Shell)
Contoh berikut menunjukkan bagaimana menggunakan tahap `$collStats` agregasi untuk mengambil statistik tentang koleksi bernama `test` dalam database. `db`
**Buat dokumen sampel**
```
db.test.insertMany([
{ "name": "John", "age": 30 },
{ "name": "Jane", "age": 25 },
{ "name": "Bob", "age": 35 }
]);
```
**Contoh kueri**
```
db.test.aggregate([
{ $collStats: {} }
]);
```
**Keluaran**
```
{
"ns" : "db.test",
"count" : 3,
"size" : 87,
"avgObjSize" : 29,
"storageSize" : 40960,
"capped" : false,
"nindexes" : 1,
"totalIndexSize" : 8192,
"indexSizes" : {
"_id_" : 8192
},
"collScans" : 0,
"idxScans" : 0,
"opCounter" : {
"numDocsIns" : 3,
"numDocsUpd" : 0,
"numDocsDel" : 0
},
"cacheStats" : {
"collBlksHit" : 0,
"collBlksRead" : 0,
"collHitRatio" : 0,
"idxBlksHit" : 0,
"idxBlksRead" : 0,
"idxHitRatio" : 0
},
"lastReset" : "2023-04-11T12:00:00Z",
"ok" : 1,
"operationTime" : Timestamp(1681206000, 1)
}
```
## Contoh kode
Untuk melihat contoh kode untuk menggunakan `$collStats` perintah, pilih tab untuk bahasa yang ingin Anda gunakan:
------
#### [ Node.js ]
Berikut adalah contoh cara menggunakan tahap `$collStats` agregasi dalam aplikasi Node.js menggunakan driver MongoDB Node.js resmi:
```
const { MongoClient } = require('mongodb');
async function runCollStatsExample() {
const client = await MongoClient.connect('mongodb://:@:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false');
const db = client.db('db');
const collection = db.collection('test');
const result = await collection.aggregate([
{ $collStats: {} }
]).toArray();
console.log(result);
await client.close();
}
runCollStatsExample();
```
------
#### [ Python ]
Berikut adalah contoh cara menggunakan tahap `$collStats` agregasi dalam aplikasi Python menggunakan PyMongo driver:
```
from pymongo import MongoClient
def run_coll_stats_example():
client = MongoClient('mongodb://:@:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false')
db = client['db']
collection = db['test']
result = list(collection.aggregate([
{ '$collStats': {} }
]))
print(result)
client.close()
run_coll_stats_example()
```
------
# \$1concat
Operator `$concat` agregasi di Amazon DocumentDB menggabungkan (atau menggabungkan) beberapa string dalam dokumen untuk menghasilkan string tunggal yang dapat dikembalikan ke aplikasi. Ini mengurangi pekerjaan yang dilakukan dalam aplikasi, karena manipulasi string dilakukan di tingkat database.
**Parameter**
+ `expression1`: String pertama yang digabungkan.
+ `expression2`: String kedua untuk digabungkan.
+ `...`: String tambahan untuk digabungkan (opsional).
## Contoh (MongoDB Shell)
Dalam contoh ini, kami menggabungkan nama depan dan belakang pengguna untuk menghasilkan nama lengkap setiap orang.
**Buat dokumen sampel**
```
db.people.insertMany([
{ "_id":1, "first_name":"Jane", "last_name":"Doe", "DOB":"2/1/1999", "Desk": "MSP102-MN"},
{ "_id":2, "first_name":"John", "last_name":"Doe", "DOB":"12/21/1992", "Desk": "DSM301-IA"},
{ "_id":3, "first_name":"Steve", "last_name":"Smith", "DOB":"3/21/1981", "Desk":"MKE233-WI"}
])
```
**Contoh kueri**
```
db.people.aggregate([
{ $project: { full_name: { $concat: [ "$first_name", " ", "$last_name"] } } }
])
```
**Keluaran**
```
{ "_id" : 1, "full_name" : "Jane Doe" }
{ "_id" : 2, "full_name" : "John Doe" }
{ "_id" : 3, "full_name" : "Steve Smith" }
```
## Contoh kode
Untuk melihat contoh kode untuk menggunakan `$concat` perintah, pilih tab untuk bahasa yang ingin Anda gunakan:
------
#### [ Node.js ]
```
const { MongoClient } = require('mongodb');
async function concatenateNames() {
const client = await MongoClient.connect('mongodb://:@:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false');
const db = client.db('test');
const result = await db.collection('people').aggregate([
{ $project: { full_name: { $concat: [ "$first_name", " ", "$last_name"] } } }
]).toArray();
console.log(result);
await client.close();
}
concatenateNames();
```
------
#### [ Python ]
```
from pymongo import MongoClient
def concatenate_names():
client = MongoClient('mongodb://:@:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false')
db = client['test']
result = list(db.people.aggregate([
{ '$project': { 'full_name': { '$concat': [ '$first_name', ' ', '$last_name' ] } } }
]))
print(result)
client.close()
concatenate_names()
```
------
# \$1concatArrays
Operator `$concatArrays` agregasi di Amazon DocumentDB digunakan untuk menggabungkan dua atau lebih array menjadi satu array. Ini dapat berguna ketika Anda perlu menggabungkan beberapa array data ke dalam satu array untuk pemrosesan atau analisis lebih lanjut.
**Parameter**
+ `array1`: Array pertama yang akan digabungkan.
+ `array2`: Array kedua yang akan digabungkan.
+ `[array3, ...]`: (opsional) Array tambahan yang akan digabungkan.
## Contoh (MongoDB Shell)
Contoh berikut menunjukkan bagaimana menggunakan `$concatArrays` operator untuk menggabungkan dua array ke dalam array tunggal.
**Buat dokumen sampel**
```
db.collection.insertMany([
{
"_id": 1,
"name": "John Doe",
"hobbies": ["reading", "swimming"],
"skills": ["programming", "design"]
},
{
"_id": 2,
"name": "Jane Smith",
"hobbies": ["hiking", "cooking"],
"skills": ["marketing", "analysis"]
}
]);
```
**Contoh kueri**
```
db.collection.aggregate([
{
$project: {
_id: 0,
name: 1,
all_activities: { $concatArrays: ["$hobbies", "$skills"] }
}
}
]);
```
**Keluaran**
```
[
{
"name": "John Doe",
"all_activities": [
"reading",
"swimming",
"programming",
"design"
]
},
{
"name": "Jane Smith",
"all_activities": [
"hiking",
"cooking",
"marketing",
"analysis"
]
}
]
```
## Contoh kode
Untuk melihat contoh kode untuk menggunakan `$concatArrays` perintah, pilih tab untuk bahasa yang ingin Anda gunakan:
------
#### [ Node.js ]
```
const { MongoClient } = require('mongodb');
async function example() {
const client = await MongoClient.connect('mongodb://:@:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false');
const db = client.db('mydb');
const collection = db.collection('mycollection');
const result = await collection.aggregate([
{
$project: {
_id: 0,
name: 1,
all_activities: { $concatArrays: ['$hobbies', '$skills'] }
}
}
]).toArray();
console.log(result);
client.close();
}
example();
```
------
#### [ Python ]
```
from pymongo import MongoClient
def example():
client = MongoClient('mongodb://:@:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false')
db = client['mydb']
collection = db['mycollection']
result = list(collection.aggregate([
{
'$project': {
'_id': 0,
'name': 1,
'all_activities': { '$concatArrays': ['$hobbies', '$skills'] }
}
}
]))
print(result)
client.close()
example()
```
------
# \$1cond
`$cond`Operator di Amazon DocumentDB digunakan untuk mengevaluasi ekspresi bersyarat dan mengembalikan salah satu dari dua ekspresi hasil yang mungkin.
**Parameter**
+ `if`: Ekspresi boolean untuk mengevaluasi.
+ `then`: Ekspresi untuk kembali jika `if` ekspresi benar.
+ `else`: Ekspresi untuk kembali jika `if` ekspresi salah.
## Contoh (MongoDB Shell)
Contoh berikut menunjukkan penggunaan `$cond` operator untuk mengembalikan nilai berdasarkan usia seseorang.
**Buat dokumen sampel**
```
db.people.insertMany([
{ _id: 1, name: "John Doe", age: 35 },
{ _id: 2, name: "Jane Doe", age: 25 },
{ _id: 3, name: "Bob Smith", age: 65 }
]);
```
**Contoh kueri**
```
db.people.aggregate([
{
$project: {
name: 1,
ageGroup: {
$cond: {
if: { $lt: ["$age", 30] },
then: "young",
else: {
$cond: {
if: { $lt: ["$age", 65] },
then: "middle-aged",
else: "elderly"
}
}
}
}
}
}
])
```
**Keluaran**
```
[
{ "_id" : 1, "name" : "John Doe", "ageGroup" : "middle-aged" },
{ "_id" : 2, "name" : "Jane Doe", "ageGroup" : "young" },
{ "_id" : 3, "name" : "Bob Smith", "ageGroup" : "elderly" }
]
```
## Contoh kode
Untuk melihat contoh kode untuk menggunakan `$cond` perintah, pilih tab untuk bahasa yang ingin Anda gunakan:
------
#### [ Node.js ]
```
const { MongoClient } = require('mongodb');
async function example() {
const client = await MongoClient.connect('mongodb://:@:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false');
const db = client.db('test');
const collection = db.collection('people');
const result = await collection.aggregate([
{ $project: {
name: 1,
ageGroup: {
$cond: {
if: { $lt: ["$age", 30] },
then: "young",
else: {
$cond: {
if: { $lt: ["$age", 65] },
then: "middle-aged",
else: "elderly"
}
}
}
}
}
}
]).toArray();
console.log(result);
client.close();
}
example();
```
------
#### [ Python ]
```
from pymongo import MongoClient
def example():
client = MongoClient('mongodb://:@:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false')
db = client.test
collection = db.people
result = list(collection.aggregate([
{
'$project': {
'name': 1,
'ageGroup': {
'$cond': {
'if': { '$lt': ["$age", 30]},
'then': "young",
'else': {
'$cond': {
'if': { '$lt': ["$age", 65]},
'then': "middle-aged",
'else': "elderly"
}
}
}
}
}
}
]))
print(result)
client.close()
example()
```
------
# \$1convert
Baru dari versi 4.0
`$convert`Operator di Amazon DocumentDB digunakan untuk mengonversi nilai dari satu tipe data ke tipe data lainnya. Operator ini berguna ketika Anda perlu melakukan operasi pada data dari berbagai jenis, seperti mengubah string ke angka atau tanggal ke stempel waktu.
**Parameter**
+ `to`: Tipe data target untuk mengonversi nilainya menjadi. Nilai yang didukung adalah `"string"`, `"double"`, `"long"`, `"int"`, `"date"`, dan `"boolean"`.
+ `from`: Tipe data saat ini dari nilai. Jika tidak ditentukan, Amazon DocumentDB akan mencoba mendeteksi tipe data secara otomatis.
+ `onError`: (opsional) Nilai yang akan dikembalikan jika konversi gagal. Dapat berupa nilai tertentu atau salah satu dari nilai khusus berikut:`"null"`,`"zerofill"`, atau`"error"`.
+ `onNull`: (opsional) Nilai untuk kembali jika nilai masukan`null`. Dapat berupa nilai tertentu atau salah satu dari nilai khusus berikut:`"null"`,`"zerofill"`, atau`"error"`.
## Contoh (MongoDB Shell)
Contoh berikut menunjukkan konversi nilai string ke tanggal menggunakan operator. `$convert`
**Buat dokumen sampel**
```
db.users.insertMany([
{ _id: 1, name: "John Doe", joinedOn: "2022-01-01" },
{ _id: 2, name: "Jane Smith", joinedOn: "2023-02-15" },
{ _id: 3, name: "Bob Johnson", joinedOn: "invalid date" }
]);
```
**Contoh kueri**
```
db.users.aggregate([
{
$project: {
_id: 1,
name: 1,
joinedOn: {
$convert: {
input: "$joinedOn",
to: "date",
onError: "null",
onNull: "null"
}
}
}
}
])
```
**Keluaran**
```
[
{ "_id" : 1, "name" : "John Doe", "joinedOn" : ISODate("2022-01-01T00:00:00Z") },
{ "_id" : 2, "name" : "Jane Smith", "joinedOn" : ISODate("2023-02-15T00:00:00Z") },
{ "_id" : 3, "name" : "Bob Johnson", "joinedOn" : null }
]
```
## Contoh kode
Untuk melihat contoh kode untuk menggunakan `$convert` perintah, pilih tab untuk bahasa yang ingin Anda gunakan:
------
#### [ Node.js ]
```
const { MongoClient } = require("mongodb");
async function example() {
const client = await MongoClient.connect("mongodb://:@:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false");
const db = client.db("test");
const users = db.collection("users");
const results = await users.aggregate([
{
$project: {
_id: 1,
name: 1,
joinedOn: {
$convert: {
input: "$joinedOn",
to: "date",
onError: "null",
onNull: "null"
}
}
}
}
]).toArray();
console.log(results);
client.close();
}
example();
```
------
#### [ Python ]
```
from pymongo import MongoClient
def example():
client = MongoClient("mongodb://:@:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false")
db = client["test"]
users = db["users"]
results = list(users.aggregate([
{
"$project": {
"_id": 1,
"name": 1,
"joinedOn": {
"$convert": {
"input": "$joinedOn",
"to": "date",
"onError": "null",
"onNull": "null"
}
}
}
}
]))
print(results)
client.close()
example()
```
------
# \$1count
Tahap `$count` agregasi di Amazon DocumentDB digunakan untuk menghitung jumlah dokumen yang masuk ke panggung. Ini sering digunakan sebagai tahap akhir dalam pipa agregasi untuk mengembalikan jumlah total dokumen yang cocok dengan tahap sebelumnya.
**Parameter**
+ `field`: Bidang untuk dihitung. Parameter ini opsional, dan jika tidak disediakan, tahap akan menghitung jumlah total dokumen input.
## Contoh (MongoDB Shell)
Contoh berikut menunjukkan bagaimana menggunakan `$count` panggung untuk mendapatkan jumlah total dokumen dalam koleksi.
**Buat dokumen sampel**
```
db.users.insertMany([
{ name: "John", age: 30 },
{ name: "Jane", age: 25 },
{ name: "Bob", age: 35 },
{ name: "Alice", age: 28 }
]);
```
**Contoh kueri**
```
db.users.aggregate([
{ $count: "total" }
]);
```
**Keluaran**
```
{ "total" : 4 }
```
Contoh agregat `users` koleksi dan menggunakan `$count` panggung untuk menghitung jumlah total dokumen.
## Contoh kode
Untuk melihat contoh kode untuk menggunakan `$count` perintah, pilih tab untuk bahasa yang ingin Anda gunakan:
------
#### [ Node.js ]
```
const { MongoClient } = require('mongodb');
async function countDocuments() {
const client = await MongoClient.connect('mongodb://:@:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false');
const db = client.db('mydb');
const collection = db.collection('users');
const result = await collection.aggregate([
{ $count: "total" }
]).toArray();
console.log(result[0].total);
await client.close();
}
countDocuments();
```
------
#### [ Python ]
```
from pymongo import MongoClient
def count_documents():
client = MongoClient('mongodb://:@:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false')
db = client['mydb']
collection = db['users']
result = list(collection.aggregate([
{ '$count': "total" }
]))
print(result[0]['total'])
client.close()
count_documents()
```
------
# \$1currentOp
Tahap `$currentOp` agregasi mengembalikan informasi tentang operasi yang sedang berjalan dalam database. Tahap ini berguna untuk memantau kueri dan operasi aktif dalam jalur agregasi.
**Parameter**
+ `allUsers`(opsional): Ketika diatur ke`true`, mengembalikan operasi untuk semua pengguna. Default-nya adalah `false`.
+ `idleConnections`(opsional): Ketika diatur ke`true`, termasuk koneksi idle. Default-nya adalah `false`.
+ `idleCursors`(opsional): Ketika diatur ke`true`, termasuk informasi tentang kursor siaga. Default-nya adalah `false`.
+ `idleSessions`(opsional): Ketika diatur ke`true`, termasuk informasi tentang sesi idle. Default-nya adalah `true`.
+ `localOps`(opsional): Ketika diatur ke`true`, termasuk operasi lokal. Default-nya adalah `false`.
## Contoh (MongoDB Shell)
Contoh berikut menunjukkan menggunakan tahap `$currentOp` agregasi untuk mengambil informasi tentang operasi baca aktif.
**Contoh kueri**
```
db.aggregate([
{ $currentOp: { allUsers: true, idleConnections: false } },
{ $match: { op: "query" } }
])
```
**Keluaran**
```
[
{
"opid": "12345",
"active": true,
"op": "query",
"ns": "test.users",
"secs_running": 2
}
]
```
## Contoh kode
Untuk melihat contoh kode untuk menggunakan `$currentOp` perintah, pilih tab untuk bahasa yang ingin Anda gunakan:
------
#### [ Node.js ]
```
const { MongoClient } = require('mongodb');
async function example() {
const client = await MongoClient.connect('mongodb://:@:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false');
const db = client.db('admin');
const result = await db.aggregate([
{ $currentOp: { allUsers: true, idleConnections: false } },
{ $match: { op: "query" } }
]).toArray();
console.log(result);
await client.close();
}
example();
```
------
#### [ Python ]
```
from pymongo import MongoClient
def example():
client = MongoClient('mongodb://:@:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false')
db = client['admin']
result = list(db.aggregate([
{ '$currentOp': { 'allUsers': True, 'idleConnections': False } },
{ '$match': { 'op': 'query' } }
]))
print(result)
client.close()
example()
```
------
# \$1 DateAdd
Baru dari versi 5.0
Operator `$dateAdd` agregasi di Amazon DocumentDB memungkinkan Anda menambahkan durasi ke nilai tanggal dan waktu.
**Parameter**
+ `date`: Nilai tanggal dan waktu untuk menambahkan durasi.
+ `duration`: Durasi untuk menambah `date` nilai. Ini dapat ditentukan sebagai objek dengan kunci untuk`years`,`months`,`weeks`, `days``hours`,`minutes`, dan`seconds`.
+ `timezone`: (opsional) Zona waktu yang akan digunakan saat melakukan penambahan tanggal. Jika tidak ditentukan, zona waktu default cluster Amazon DocumentDB digunakan.
## Contoh (MongoDB Shell)
Contoh berikut menunjukkan bagaimana menggunakan `$dateAdd` operator untuk menambahkan 2 hari dan 12 jam ke tanggal.
**Buat dokumen sampel**
```
db.events.insertMany([
{ _id: 1, eventDate: ISODate("2023-04-01T10:00:00Z") },
{ _id: 2, eventDate: ISODate("2023-04-02T12:00:00Z") },
{ _id: 3, eventDate: ISODate("2023-04-03T14:00:00Z") }
]);
```
**Contoh kueri**
```
db.events.aggregate([
{
$project: {
_id: 1,
eventDate: 1,
eventDatePlustwodaysandtwelvehours: {
$dateAdd: {
startDate: {
$dateAdd: {
startDate: "$eventDate",
unit: "day",
amount: 2
}
},
unit: "hour",
amount: 12
}
}
}
}
])
```
**Keluaran**
```
[
{
"_id": 1,
"eventDate": "2023-04-01T10:00:00Z",
"eventDatePlustwodaysandtwelvehours": ISODate("2023-04-03T22:00:00Z)"
},
{
"_id": 2,
"eventDate": "2023-04-02T12:00:00Z",
"eventDatePlustwodaysandtwelvehours": ISODate("2023-04-05T00:00:00Z)"
},
{
"_id": 3,
"eventDate": "2023-04-03T14:00:00Z",
"eventDatePlustwodaysandtwelvehours": ISODate("2023-04-06T02:00:00Z)"
}
]
```
## Contoh kode
Untuk melihat contoh kode untuk menggunakan `$dateAdd` perintah, pilih tab untuk bahasa yang ingin Anda gunakan:
------
#### [ Node.js ]
```
const { MongoClient } = require('mongodb');
async function example() {
const client = await MongoClient.connect('mongodb://:@:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false');
const db = client.db('test');
const collection = db.collection('events');
const result = await collection.aggregate([
{
$project: {
_id: 1,
eventDate: 1,
eventDatePlustwodaysandtwelvehours: {
$dateAdd: {
startDate: {
$dateAdd: {
startDate: "$eventDate",
unit: "day",
amount: 2
}
},
unit: "hour",
amount: 12
}
}
}
}
]).toArray();
console.log(result);
await client.close();
}
example();
```
------
#### [ Python ]
```
from pymongo import MongoClient
from bson.date_time import datetime
def example():
client = MongoClient('mongodb://:@:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false')
db = client['test']
collection = db['events']
result = list(collection.aggregate([
{
'$project': {
'_id': 1,
'eventDate': 1,
'eventDatePlustwodaysandtwelvehours': {
'$dateAdd': {
'startDate': {
'$dateAdd' : {
'startDate': '$eventDate',
'unit': 'day',
'amount': 2,
}
},
'unit': 'hour',
'amount': 12,
}
}
}
}
]))
print(result)
client.close()
example()
```
------
# \$1 DateDiff
Baru dari versi 5.0
Tidak didukung oleh cluster elastis.
Operator `$dateDiff` agregasi menghitung perbedaan antara dua tanggal dalam satuan tertentu. Ini mengembalikan jumlah batas unit yang dilintasi antara tanggal mulai dan akhir.
**Parameter**
+ `startDate`: Ekspresi tanggal awal.
+ `endDate`: Ekspresi tanggal akhir.
+ `unit`: Satuan waktu untuk perbedaan. Unit yang didukung adalah `year``quarter`,`month`,`week`,`day`,`hour`,`minute`,`second`, dan`millisecond`.
## Contoh (MongoDB Shell)
Contoh berikut menunjukkan bagaimana menggunakan `$dateDiff` operator untuk menghitung jumlah hari antara penempatan pesanan dan pengiriman.
**Buat dokumen sampel**
```
db.shipments.insertMany([
{
orderId: 1001,
orderDate: ISODate("2025-01-10T08:00:00Z"),
deliveryDate: ISODate("2025-01-15T14:30:00Z")
},
{
orderId: 1002,
orderDate: ISODate("2025-02-05T10:00:00Z"),
deliveryDate: ISODate("2025-02-12T16:45:00Z")
}
]);
```
**Contoh kueri**
```
db.shipments.aggregate([
{
$project: {
orderId: 1,
orderDate: 1,
deliveryDate: 1,
daysToDeliver: {
$dateDiff: {
startDate: "$orderDate",
endDate: "$deliveryDate",
unit: "day"
}
}
}
}
]);
```
**Keluaran**
```
[
{
_id: ObjectId('6924a5f2d66dcae121d29517'),
orderId: 1001,
orderDate: ISODate('2025-01-10T08:00:00.000Z'),
deliveryDate: ISODate('2025-01-15T14:30:00.000Z'),
daysToDeliver: 5
},
{
_id: ObjectId('6924a5f2d66dcae121d29518'),
orderId: 1002,
orderDate: ISODate('2025-02-05T10:00:00.000Z'),
deliveryDate: ISODate('2025-02-12T16:45:00.000Z'),
daysToDeliver: 7
}
]
```
## Contoh kode
Untuk melihat contoh kode untuk menggunakan `$dateDiff` perintah, pilih tab untuk bahasa yang ingin Anda gunakan:
------
#### [ Node.js ]
```
const { MongoClient } = require('mongodb');
async function example() {
const client = await MongoClient.connect('mongodb://:@:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false');
const db = client.db('test');
const shipments = db.collection('shipments');
const result = await shipments.aggregate([
{
$project: {
orderId: 1,
orderDate: 1,
deliveryDate: 1,
daysToDeliver: {
$dateDiff: {
startDate: "$orderDate",
endDate: "$deliveryDate",
unit: "day"
}
}
}
}
]).toArray();
console.log(result);
client.close();
}
example();
```
------
#### [ Python ]
```
from pymongo import MongoClient
def example():
client = MongoClient('mongodb://:@:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false')
db = client['test']
shipments = db['shipments']
result = list(shipments.aggregate([
{
"$project": {
"orderId": 1,
"orderDate": 1,
"deliveryDate": 1,
"daysToDeliver": {
"$dateDiff": {
"startDate": "$orderDate",
"endDate": "$deliveryDate",
"unit": "day"
}
}
}
}
]))
print(result)
client.close()
example()
```
------
# \$1dateFromString
Operator `$dateFromString` agregasi di Amazon DocumentDB memungkinkan Anda mengonversi string tanggal-waktu menjadi objek tanggal. Ini berguna ketika data Anda disimpan sebagai string tetapi Anda perlu melakukan operasi berbasis tanggal pada data.
**Parameter**
+ `dateString`: String yang mewakili tanggal dan waktu.
+ `format`: (opsional) Sebuah string yang menentukan format. `dateString` Jika tidak disediakan, Amazon DocumentDB akan mencoba mengurai string dalam format ISO-8601.
+ `timezone`: (opsional) Sebuah string yang menentukan zona waktu. Jika tidak disediakan, Amazon DocumentDB akan menggunakan zona waktu server.
+ `onError`: (opsional) Menentukan tindakan yang akan diambil jika konversi gagal. Nilai yang mungkin adalah `'error'` (default, yang melempar kesalahan), `'null'` (mengembalikan`null`), atau `'replace'` (menggantikan nilai dengan string pengganti yang ditentukan dalam `onErrorMessage` opsi).
+ `onErrorMessage`: (opsional) Jika `onError` diatur ke`'replace'`, opsi ini menentukan string pengganti.
## Contoh (MongoDB Shell)
Contoh berikut menunjukkan bagaimana menggunakan untuk mengkonversi string tanggal `$dateFromString` ke objek tanggal di Amazon DocumentDB.
**Buat dokumen sampel**
```
db.missionLog.insertMany([
{ _id: 1, event: "missionStart", logDate: "2020-03-15T13:41:33"},
{ _id: 2, event: "jumpPoint1", logDate: "2020-03-15T13:45:34"},
{ _id: 3, event: "jumpPoint2", logDate: "2020-03-15T13:48:21"},
{ _id: 4, event: "jumpPoint3", logDate: "2020-03-15T13:52:09"},
{ _id: 5, event: "missionEnd", logDate: "2020-03-15T13:58:44"}
]);
```
**Contoh kueri**
```
db.missionLog.aggregate([
{
$project: {
event: '$event',
logDate: {
$dateFromString: {
dateString: '$logDate'
}
}
}
}
]);
```
**Keluaran**
```
[
{
"_id": 1,
"event": "missionStart",
"logDate": ISODate("2020-03-15T13:41:33Z")
},
{
"_id": 2,
"event": "jumpPoint1",
"logDate": ISODate("2020-03-15T13:45:34Z")
},
{
"_id": 3,
"event": "jumpPoint2",
"logDate": ISODate("2020-03-15T13:48:21Z")
},
{
"_id": 4,
"event": "jumpPoint3",
"logDate": ISODate("2020-03-15T13:52:09Z")
},
{
"_id": 5,
"event": "missionEnd",
"logDate": ISODate("2020-03-15T13:58:44Z")
}
]
```
## Contoh kode
Untuk melihat contoh kode untuk menggunakan `$dateFromString` perintah, pilih tab untuk bahasa yang ingin Anda gunakan:
------
#### [ Node.js ]
```
const { MongoClient } = require('mongodb');
async function example() {
const client = await MongoClient.connect('mongodb://:@:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false');
const db = client.db('test');
const collection = db.collection('missionLog');
const result = await collection.aggregate([
{
$project: {
event: '$event',
logDate: {
$dateFromString: {
dateString: '$logDate'
}
}
}
}
]).toArray();
console.log(result);
await client.close();
}
example();
```
------
#### [ Python ]
```
from pymongo import MongoClient
def example():
client = MongoClient('mongodb://:@:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false')
db = client['test']
collection = db['missionLog']
result = list(collection.aggregate([
{
'$project': {
'event': '$event',
'logDate': {
'$dateFromString': {
'dateString': '$logDate'
}
}
}
}
]))
print(result)
client.close()
example()
```
------
# \$1 DateSubtract
Baru dari versi 5.0
Operator `$dateSubtract` agregasi di Amazon DocumentDB memungkinkan Anda mengurangi durasi tertentu dari nilai tanggal.
**Parameter**
+ `date`: Ekspresi tanggal yang menyelesaikan tanggal atau stempel waktu.
+ `subtrahend`: Ekspresi durasi yang menentukan jumlah waktu untuk mengurangi dari ekspresi. `date`
+ `unit`: Sebuah string yang menentukan satuan waktu untuk `subtrahend` ekspresi. Unit yang didukung adalah “tahun”, “kuartal”, “bulan”, “minggu”, “hari”, “jam”, “menit”, “kedua”, dan “milidetik”.
## Contoh (MongoDB Shell)
Contoh berikut menunjukkan cara menggunakan `$dateSubtract` operator untuk menghitung tanggal satu tahun yang lalu dari tanggal saat ini.
**Buat dokumen sampel**
```
db.events.insertOne({
eventName: "Player joined",
eventTime: ISODate("2023-04-01T12:00:00Z")
});
```
**Contoh kueri**
```
db.events.aggregate([
{
$project: {
eventName: 1,
oneYearAgo: {
$dateSubtract: {
startDate: "$eventTime",
amount: 1,
unit: "year"
}
}
}
}
])
```
**Keluaran**
```
{
"_id" : ObjectId("64567890abcdef012345678"),
"eventName" : "Player joined",
"oneYearAgo" : ISODate("2022-04-01T12:00:00Z")
}
```
## Contoh kode
Untuk melihat contoh kode untuk menggunakan `$dateSubtract` perintah, pilih tab untuk bahasa yang ingin Anda gunakan:
------
#### [ Node.js ]
```
const { MongoClient } = require('mongodb');
async function example() {
const client = await MongoClient.connect('mongodb://:@:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false');
const db = client.db('test');
const events = db.collection('events');
const result = await events.aggregate([
{
$project: {
eventName: 1,
oneYearAgo: {
$dateSubtract: {
startDate: "$eventTime",
amount: 1,
unit: "year"
}
}
}
}
]).toArray();
console.log(result);
await client.close();
}
example();
```
------
#### [ Python ]
```
from pymongo import MongoClient
from bson.date_time import datetime
def example():
client = MongoClient('mongodb://:@:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false')
db = client['test']
events = db['events']
result = list(events.aggregate([
{
'$project': {
'eventName': 1,
'oneYearAgo': {
'$dateSubtract': {
'startDate': '$eventTime',
'amount': 1,
'unit': 'year'
}
}
}
}
]))
print(result)
client.close()
example()
```
------
# \$1dateToString
Operator `$dateToString` agregasi di Amazon DocumentDB digunakan untuk mengonversi nilai tanggal atau stempel waktu menjadi representasi string. Ini berguna ketika Anda perlu memformat tanggal dan waktu dengan cara tertentu untuk tampilan atau pemrosesan lebih lanjut.
**Parameter**
+ `date`: Nilai tanggal atau stempel waktu yang akan dikonversi ke string.
+ `format`: Sebuah string yang menentukan format di mana tanggal harus diwakili. String format dapat mencakup berbagai penentu format, seperti `%Y` untuk tahun empat digit, `%m` untuk bulan dua digit, `%d` untuk hari dua digit dalam sebulan, dll.
+ `timezone`: (opsional) Zona waktu yang akan digunakan untuk konversi. Jika tidak ditentukan, zona waktu server yang menghosting cluster Amazon DocumentDB digunakan.
+ `onNull`: (opsional) Nilai yang akan dikembalikan jika `date` parameternya`null`.
## Contoh (MongoDB Shell)
Contoh berikut menunjukkan penggunaan `$dateToString` operator untuk memformat `logDate` bidang `missionLog` koleksi.
**Buat dokumen sampel**
```
db.missionLog.insertMany([
{ _id: 1, "event":"missionStart", logDate: new Date("2020-03-15T13:41:33Z") },
{ _id: 2, "event":"jumpPoint1", logDate: new Date("2020-03-15T13:45:34Z") },
{ _id: 3, "event":"jumpPoint2", logDate: new Date("2020-03-15T13:48:21Z") },
{ _id: 4, "event":"jumpPoint3", logDate: new Date("2020-03-15T13:52:09Z") },
{ _id: 5, "event":"missionEnd", logDate: new Date("2020-03-15T13:58:44Z") }
]);
```
**Contoh kueri**
```
db.missionLog.aggregate([
{
$project: {
event: "$event",
logDateFormatted: {
$dateToString: {
format: "%Y-%m-%d %H:%M:%S",
date: "$logDate"
}
}
}
}
])
```
**Keluaran**
```
[
{
"_id": 1,
"event": "missionStart",
"logDateFormatted": "2020-03-15 13:41:33"
},
{
"_id": 2,
"event": "jumpPoint1",
"logDateFormatted": "2020-03-15 13:45:34"
},
{
"_id": 3,
"event": "jumpPoint2",
"logDateFormatted": "2020-03-15 13:48:21"
},
{
"_id": 4,
"event": "jumpPoint3",
"logDateFormatted": "2020-03-15 13:52:09"
},
{
"_id": 5,
"event": "missionEnd",
"logDateFormatted": "2020-03-15 13:58:44"
}
]
```
## Contoh kode
Untuk melihat contoh kode untuk menggunakan `$dateToString` perintah, pilih tab untuk bahasa yang ingin Anda gunakan:
------
#### [ Node.js ]
Berikut adalah contoh penggunaan `$dateToString` operator dalam aplikasi Node.js:
```
const { MongoClient } = require('mongodb');
async function example() {
const client = await MongoClient.connect('mongodb://:@:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false');
const db = client.db('test');
const collection = db.collection('missionLog');
const result = await collection.aggregate([
{
$project: {
event: "$event",
logDateFormatted: {
$dateToString: {
format: "%Y-%m-%d %H:%M:%S",
date: "$logDate"
}
}
}
}
]).toArray();
console.log(result);
await client.close();
}
example();
```
------
#### [ Python ]
Berikut adalah contoh penggunaan `$dateToString` operator dalam aplikasi Python:
```
from pymongo import MongoClient
def example():
client = MongoClient('mongodb://:@:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false')
db = client['test']
collection = db['missionLog']
pipeline = [
{
'$project': {
'event': '$event',
'logDateFormatted': {
'$dateToString': {
'format': '%Y-%m-%d %H:%M:%S',
'date': '$logDate'
}
}
}
}
]
result = list(collection.aggregate(pipeline))
print(result)
client.close()
example()
```
------
# \$1 DateTrunc
Baru dari versi 8.0
Tidak didukung oleh cluster elastis.
Operator `$dateTrunc` agregasi di Amazon DocumentDB memotong tanggal ke unit tertentu.
**Parameter**
+ `date`: Ekspresi tanggal yang menyelesaikan tanggal atau stempel waktu.
+ `unit`: Sebuah string yang menentukan satuan waktu untuk ekspresi subtrahend. Unit yang didukung adalah `year``quarter`,`month`,,`week`,`day`,`hour`,`minute`,`second`, dan`millisecond`.
## Contoh (MongoDB Shell)
Contoh berikut menunjukkan cara menggunakan `$dateTrunc` operator untuk memotong tanggal ke jam.
**Buat dokumen sampel**
```
db.events.insertMany([
{
eventName: "Event 1",
eventTime: ISODate("2025-04-01T12:15:00Z")
},
{
eventName: "Event 2",
eventTime: ISODate("2025-08-15T14:33:22Z")
},
]);
```
**Contoh kueri**
```
db.events.aggregate([
{
$project: {
eventName: 1,
eventTime: 1,
truncatedToHour: {
$dateTrunc: {
date: "$eventTime",
unit: "hour"
}
}
}
}
]);
```
**Keluaran**
```
[
{
_id: ObjectId('6924a258d66dcae121d29515'),
eventName: 'Event 1',
eventTime: ISODate('2025-04-01T12:15:00.000Z'),
truncatedToHour: ISODate('2025-04-01T12:00:00.000Z')
},
{
_id: ObjectId('6924a258d66dcae121d29516'),
eventName: 'Event 2',
eventTime: ISODate('2025-08-15T14:33:22.000Z'),
truncatedToHour: ISODate('2025-08-15T14:00:00.000Z')
}
]
```
## Contoh kode
Untuk melihat contoh kode untuk menggunakan `$dateTrunc` perintah, pilih tab untuk bahasa yang ingin Anda gunakan:
------
#### [ Node.js ]
```
const { MongoClient } = require('mongodb');
async function example() {
const client = await MongoClient.connect('mongodb://:@:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false');
const db = client.db('test');
const events = db.collection('events');
const result = await events.aggregate([
{
$project: {
eventName: 1,
eventTime: 1,
truncatedToHour: {
$dateTrunc: {
date: "$eventTime",
unit: "hour"
}
}
}
}
]).toArray();
console.log(result);
client.close();
}
example();
```
------
#### [ Python ]
```
from pymongo import MongoClient
def example():
client = MongoClient('mongodb://:@:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false')
db = client['test']
events = db['events']
result = list(events.aggregate([
{
"$project": {
"eventName": 1,
"eventTime": 1,
"truncatedToHour": {
"$dateTrunc": {
"date": "$eventTime",
"unit": "hour"
}
}
}
}
]))
print(result)
client.close()
example()
```
------
# \$1dayOfMonth
Operator `$dayOfMonth` agregasi di Amazon DocumentDB mengambil hari dalam sebulan (dari 1 hingga 31) untuk tanggal tertentu. Operator ini berguna untuk mengelompokkan, memfilter, atau mengekstrak hari dalam sebulan dari bidang tanggal dalam dokumen Anda.
**Parameter**
+ `date expression`: Ekspresi tanggal dapat berupa bidang tanggal dari dokumen, objek tanggal, atau string tanggal.
## Contoh (MongoDB Shell)
Contoh ini menunjukkan cara menggunakan `$dayOfMonth` operator untuk mengekstrak hari dalam sebulan dari bidang tanggal dalam dokumen.
**Buat dokumen sampel**
```
db.events.insertMany([
{ _id: 1, eventDate: new Date("2022-01-15T12:00:00Z") },
{ _id: 2, eventDate: new Date("2022-02-28T15:30:00Z") },
{ _id: 3, eventDate: new Date("2022-03-01T09:45:00Z") },
{ _id: 4, eventDate: new Date("2022-04-30T23:59:59Z") }
]);
```
**Contoh kueri**
```
db.events.aggregate([
{ $project: {
eventDay: { $dayOfMonth: "$eventDate" }
}}
])
```
**Keluaran**
```
[
{ "_id" : 1, "eventDay" : 15 },
{ "_id" : 2, "eventDay" : 28 },
{ "_id" : 3, "eventDay" : 1 },
{ "_id" : 4, "eventDay" : 30 }
]
```
## Contoh kode
Untuk melihat contoh kode untuk menggunakan `$dayOfMonth` perintah, pilih tab untuk bahasa yang ingin Anda gunakan:
------
#### [ Node.js ]
```
const { MongoClient } = require('mongodb');
async function example() {
const client = await MongoClient.connect('mongodb://:@:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false');
const db = client.db('test');
const events = db.collection('events');
const result = await events.aggregate([
{ $project: {
eventDay: { $dayOfMonth: "$eventDate" }
}}
]).toArray();
console.log(result);
await client.close();
}
example();
```
------
#### [ Python ]
```
from pymongo import MongoClient
def example():
client = MongoClient('mongodb://:@:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false')
db = client.mydatabase
events = db.events
result = list(events.aggregate([
{ "$project": {
"eventDay": { "$dayOfMonth": "$eventDate" }
}}
]))
print(result)
client.close()
example()
```
------
# \$1dayOfWeek
`$dayOfWeek`Operator di Amazon DocumentDB mengekstrak hari dalam seminggu dari bidang tanggal tertentu. Ini mengembalikan hari dalam seminggu sebagai angka antara 1 (Minggu) dan 7 (Sabtu), yang merupakan perilaku yang sama seperti di MongoDB.
**Parameter**
+ `date field`: Bidang tanggal untuk mengekstrak hari dalam seminggu dari.
## Contoh (MongoDB Shell)
Contoh ini menunjukkan cara menggunakan `$dayOfWeek` operator untuk mengekstrak hari dalam seminggu dari `date` bidang dalam `weather` koleksi.
**Buat dokumen sampel**
```
db.weather.insertMany([
{
"temperature": 97.5,
"humidity": 0.60,
"date": new Date("2023-04-01")
},
{
"temperature": 95.2,
"humidity": 0.55,
"date": new Date("2023-04-02")
},
{
"temperature": 92.8,
"humidity": 0.65,
"date": new Date("2023-04-03")
}
]);
```
**Contoh kueri**
```
db.weather.aggregate([
{
$project: {
dayOfWeek: { $dayOfWeek: "$date" }
}
}
]).pretty();
```
**Keluaran**
```
{ "_id" : ObjectId("64272c6663f4f8ce422c2d91"), "dayOfWeek" : 7 }
{ "_id" : ObjectId("64272c6663f4f8ce422c2d92"), "dayOfWeek" : 1 }
{ "_id" : ObjectId("64272c6663f4f8ce422c2d93"), "dayOfWeek" : 2 }
```
## Contoh kode
Untuk melihat contoh kode untuk menggunakan `$dayOfWeek` perintah, pilih tab untuk bahasa yang ingin Anda gunakan:
------
#### [ Node.js ]
```
const { MongoClient } = require('mongodb');
async function main() {
const client = await MongoClient.connect('mongodb://:@:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false');
const db = client.db('test');
const collection = db.collection('weather');
const result = await collection.aggregate([
{
$project: {
dayOfWeek: { $dayOfWeek: '$date' }
}
}
]).toArray();
console.log(result);
await client.close();
}
main();
```
------
#### [ Python ]
```
from pymongo import MongoClient
def main():
client = MongoClient('mongodb://:@:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false')
db = client.test
collection = db.weather
result = list(collection.aggregate([
{
'$project': {
'dayOfWeek': { '$dayOfWeek': '$date' }
}
}
]))
print(result)
client.close()
if __name__ == '__main__':
main()
```
------
# \$1dayOfYear
`$dayOfYear`Operator di Amazon DocumentDB mengembalikan hari dalam setahun untuk tanggal sebagai angka antara 1 dan 366 (365 dalam tahun non-kabisat).
**Parameter**
+ `expression`: Bidang tanggal atau ekspresi untuk mengekstrak hari dalam setahun.
## Contoh (MongoDB Shell)
Contoh ini menunjukkan cara menggunakan `$dayOfYear` operator untuk mengekstrak hari dalam setahun dari bidang tanggal dalam koleksi Amazon DocumentDB.
**Buat dokumen sampel**
```
db.weather.insert([
{
"temperature" : 97.5,
"humidity": 0.60,
"date" : new Date("2023-03-15")
},
{
"temperature" : 82.3,
"humidity": 0.75,
"date" : new Date("2023-12-31")
}
])
```
**Contoh kueri**
```
db.weather.aggregate([
{
$project: {
dayOfYear: { $dayOfYear: "$date" }
}
}
]).pretty()
```
**Keluaran**
```
{ "_id" : ObjectId("642b86fc7d8e07af279bbe63"), "dayOfYear" : 74 }
{ "_id" : ObjectId("642b86fc7d8e07af279bbe64"), "dayOfYear" : 365 }
```
## Contoh kode
Untuk melihat contoh kode untuk menggunakan `$dayOfYear` perintah, pilih tab untuk bahasa yang ingin Anda gunakan:
------
#### [ Node.js ]
```
const { MongoClient } = require('mongodb');
async function example() {
const client = await MongoClient.connect('mongodb://:@:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false');
const db = client.db('test');
const collection = db.collection('weather');
const result = await collection.aggregate([
{
$project: {
dayOfYear: { $dayOfYear: "$date" }
}
}
]).toArray();
console.log(result);
await client.close();
}
example();
```
------
#### [ Python ]
```
from pymongo import MongoClient
def example():
client = MongoClient('mongodb://:@:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false')
db = client['test']
collection = db['weather']
result = list(collection.aggregate([
{
'$project': {
'dayOfYear': { '$dayOfYear': '$date' }
}
}
]))
print(result)
client.close()
example()
```
------
# \$1divide
`$divide`Operator di jalur agregasi Amazon DocumentDB digunakan untuk membagi satu nomor dengan yang lain. Ini adalah operator yang berguna untuk melakukan operasi matematika pada bidang numerik dalam dokumen Anda.
**Parameter**
+ `numerator`: Dividen atau nomor yang akan dibagi.
+ `denominator`: Pembagi atau nomor untuk dibagi dengan.
## Contoh (MongoDB Shell)
Contoh ini menunjukkan cara menggunakan `$divide` operator untuk menghitung tarif per jam untuk karyawan berdasarkan gaji tahunan mereka dan jumlah jam kerja per tahun.
**Buat dokumen sampel**
```
db.employees.insertMany([
{ _id: 1, name: "John Doe", salary: 80000, hoursPerYear: 2080 },
{ _id: 2, name: "Jane Smith", salary: 90000, hoursPerYear: 2080 },
{ _id: 3, name: "Bob Johnson", salary: 75000, hoursPerYear: 2080 }
]);
```
**Contoh kueri**
```
db.employees.aggregate([
{
$project: {
name: 1,
hourlyRate: { $divide: ["$salary", "$hoursPerYear"] }
}
}
])
```
**Keluaran**
```
[
{ "_id" : 1, "name" : "John Doe", "hourlyRate" : 38.46153846153846 },
{ "_id" : 2, "name" : "Jane Smith", "hourlyRate" : 43.26923076923077 },
{ "_id" : 3, "name" : "Bob Johnson", "hourlyRate" : 36.05769230769231 }
]
```
## Contoh kode
Untuk melihat contoh kode untuk menggunakan `$divide` perintah, pilih tab untuk bahasa yang ingin Anda gunakan:
------
#### [ Node.js ]
```
const { MongoClient } = require('mongodb');
async function calculateHourlyRate() {
const client = await MongoClient.connect('mongodb://:@:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false');
const db = client.db('test');
const employees = db.collection('employees');
const result = await employees.aggregate([
{
$project: {
name: 1,
hourlyRate: { $divide: ["$salary", "$hoursPerYear"] }
}
}
]).toArray();
console.log(result);
client.close();
}
calculateHourlyRate();
```
------
#### [ Python ]
```
from pymongo import MongoClient
def calculate_hourly_rate():
client = MongoClient('mongodb://:@:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false')
db = client.mydatabase
employees = db.employees
result = list(employees.aggregate([
{
'$project': {
'name': 1,
'hourlyRate': { '$divide': ['$salary', '$hoursPerYear'] }
}
}
]))
print(result)
client.close()
calculate_hourly_rate()
```
------
# \$1eq
Operator `$eq` agregasi membandingkan dua nilai dan kembali `true` jika mereka sama, jika tidak kembali. `false`
**Parameter**
+ `expression1`: Nilai pertama untuk membandingkan.
+ `expression2`: Nilai kedua untuk membandingkan.
## Contoh (MongoDB Shell)
Contoh berikut menunjukkan menggunakan `$eq` operator untuk memeriksa apakah jumlah produk cocok dengan nilai target.
**Buat dokumen sampel**
```
db.inventory.insertMany([
{ _id: 1, item: "Widget", qty: 50, target: 50 },
{ _id: 2, item: "Gadget", qty: 30, target: 50 },
{ _id: 3, item: "Tool", qty: 50, target: 40 }
]);
```
**Contoh kueri**
```
db.inventory.aggregate([
{
$project: {
item: 1,
qty: 1,
target: 1,
meetsTarget: { $eq: ["$qty", "$target"] }
}
}
]);
```
**Keluaran**
```
[
{ _id: 1, item: 'Widget', qty: 50, target: 50, meetsTarget: true },
{ _id: 2, item: 'Gadget', qty: 30, target: 50, meetsTarget: false },
{ _id: 3, item: 'Tool', qty: 50, target: 40, meetsTarget: false }
]
```
## Contoh kode
Untuk melihat contoh kode untuk menggunakan operator `$eq` agregasi, pilih tab untuk bahasa yang ingin Anda gunakan:
------
#### [ Node.js ]
```
const { MongoClient } = require('mongodb');
async function example() {
const client = await MongoClient.connect('mongodb://:@:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false');
const db = client.db('test');
const collection = db.collection('inventory');
const result = await collection.aggregate([
{
$project: {
item: 1,
qty: 1,
target: 1,
meetsTarget: { $eq: ["$qty", "$target"] }
}
}
]).toArray();
console.log(result);
await client.close();
}
example();
```
------
#### [ Python ]
```
from pymongo import MongoClient
def example():
client = MongoClient('mongodb://:@:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false')
db = client['test']
collection = db['inventory']
result = list(collection.aggregate([
{
'$project': {
'item': 1,
'qty': 1,
'target': 1,
'meetsTarget': { '$eq': ['$qty', '$target'] }
}
}
]))
print(result)
client.close()
example()
```
------
# \$1exp
Baru dari versi 4.0
`$exp`Operator di Amazon DocumentDB memungkinkan Anda menaikkan konstanta e ke nomor tertentu.
**Parameter**
+ `expression`: Ekspresi untuk mengevaluasi. Ini dapat berupa ekspresi agregasi yang valid, termasuk referensi bidang, operasi aritmatika, dan tahap agregasi lainnya.
## Contoh (MongoDB Shell)
Contoh berikut menunjukkan penggunaan `$exp` operator untuk menemukan semua dokumen di mana `quantity` bidang lebih besar dari `price` bidang.
**Buat dokumen sampel**
```
db.items.insertMany([
{ item: "canvas", quantity: 4 },
{ item: "journal", quantity: 2 }
]);
```
**Contoh kueri**
```
db.items.aggregate([
{ $project: {
"quantityRaised": {$exp: "$quantity"}}
}
]);
```
**Keluaran**
```
[
{
_id: ObjectId('6920b785311cf98b79d2950d'),
quantityRaised: 54.598150033144236
},
{
_id: ObjectId('6920b785311cf98b79d2950e'),
quantityRaised: 7.38905609893065
}
]
```
## Contoh kode
Untuk melihat contoh kode untuk menggunakan `$exp` perintah, pilih tab untuk bahasa yang ingin Anda gunakan:
------
#### [ Node.js ]
```
const { MongoClient } = require('mongodb');
async function aggregateExp() {
const client = await MongoClient.connect('mongodb://:@:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false');
const db = client.db('test');
const items = db.collection('items');
const result = await items.aggregate([
{ $project: {
"quantityRaised": {$exp: "$quantity"}}
}
]).toArray();
console.log(result);
client.close();
}
aggregateExp();
```
------
#### [ Python ]
```
from pymongo import MongoClient
def aggregate_exp():
client = MongoClient('mongodb://:@:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false')
db = client.test
items = db.items
result = list(items.aggregate([
{ "$project": {
"quantityRaised": {"$exp": "$quantity"}}
}
]))
print(result)
client.close()
aggregate_exp()
```
------
# \$1filter
`$filter`Operator di Amazon DocumentDB digunakan untuk menerapkan ekspresi filter ke setiap elemen array dan mengembalikan array yang hanya berisi elemen yang cocok dengan kondisi yang ditentukan. Operator ini berguna ketika Anda perlu melakukan operasi penyaringan kompleks pada bidang array dalam dokumen Anda.
**Parameter**
+ `input`: Bidang array untuk menyaring.
+ `as`: Nama variabel yang digunakan untuk setiap elemen `input` array dalam `cond` ekspresi.
+ `cond`: Ekspresi boolean yang menentukan apakah elemen tertentu harus disertakan dalam array output.
## Contoh (MongoDB Shell)
Contoh berikut menunjukkan cara menggunakan `$filter` operator untuk memproyeksikan pelanggan setiap pesanan dan membuat bidang array baru PaidItem berisi hanya item dari array item di mana harga lebih besar dari 15. Pada dasarnya, ini menyaring item setiap pesanan untuk memasukkan hanya produk yang harganya lebih dari 15.
**Buat dokumen sampel**
```
db.orders.insertMany([
{ _id: 1, customer: "abc123", items: [
{ name: "Product A", price: 10, qty: 2 },
{ name: "Product B", price: 20, qty: 1 }
]},
{ _id: 2, customer: "def456", items: [
{ name: "Product C", price: 5, qty: 3 },
{ name: "Product D", price: 15, qty: 4 }
]},
{ _id: 3, customer: "ghi789", items: [
{ name: "Product E", price: 8, qty: 3 },
{ name: "Product F", price: 12, qty: 1 }
]}
]);
```
**Contoh kueri**
```
db.orders.aggregate([
{
$project: {
customer: 1,
paidItems: {
$filter: {
input: "$items",
as: "item",
cond: { $gt: ["$$item.price", 15] }
}
}
}
}
]).pretty();
```
**Keluaran**
```
[
{
_id: 1,
customer: 'abc123',
paidItems: [ { name: 'Product B', price: 20, qty: 1 } ]
},
{ _id: 2, customer: 'def456', paidItems: [] },
{ _id: 3, customer: 'ghi789', paidItems: [] }
]
```
## Contoh kode
Untuk melihat contoh kode untuk menggunakan `$filter` perintah, pilih tab untuk bahasa yang ingin Anda gunakan:
------
#### [ Node.js ]
```
const { MongoClient } = require('mongodb');
async function example() {
const uri = 'mongodb://:@:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false';
const client = new MongoClient(uri);
try {
await client.connect();
const db = client.db('test');
const collection = db.collection('orders');
const result = await collection.aggregate([
{
$project: {
customer: 1,
paidItems: {
$filter: {
input: "$items",
as: "item",
cond: { $gt: ["$$item.price", 15] }
}
}
}
}
]).toArray();
console.log(JSON.stringify(result, null, 2));
} catch (error) {
console.error('Error:', error);
} finally {
await client.close();
}
}
example();
```
------
#### [ Python ]
```
from pymongo import MongoClient
from pprint import pprint
def example():
uri = 'mongodb://:@:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false'
with MongoClient(uri) as client:
db = client.test
collection = db.orders
result = list(collection.aggregate([
{
'$project': {
'customer': 1,
'paidItems': {
'$filter': {
'input': '$items',
'as': 'item',
'cond': { '$gt': ['$$item.price', 15] }
}
}
}
}
]))
for doc in result:
pprint(doc)
example()
```
------
# \$1first
Baru dari versi 5.0.
Tidak didukung oleh cluster elastis.
`$first`Operator di Amazon DocumentDB mengembalikan dokumen pertama dari kumpulan dokumen yang dikelompokkan. Hal ini biasanya digunakan dalam pipeline agregasi untuk mengambil dokumen pertama yang cocok dengan kondisi tertentu.
**Parameter**
+ `expression`: Ekspresi untuk kembali sebagai nilai pertama di setiap grup.
## Contoh (MongoDB Shell)
Contoh berikut menunjukkan penggunaan `$first` operator untuk mengambil nilai item pertama yang ditemui untuk setiap kategori selama agregasi.
Catatan: `$first` mengembalikan dokumen pertama berdasarkan urutan dokumen saat ini dalam pipeline. Untuk memastikan pesanan tertentu (misalnya, berdasarkan tanggal, harga, dll.), `$sort` Tahap harus digunakan sebelum `$group` tahap.
**Buat dokumen sampel**
```
db.products.insertMany([
{ _id: 1, item: "abc", price: 10, category: "food" },
{ _id: 2, item: "jkl", price: 20, category: "food" },
{ _id: 3, item: "xyz", price: 5, category: "toy" },
{ _id: 4, item: "abc", price: 5, category: "toy" }
]);
```
**Contoh kueri**
```
db.products.aggregate([
{ $group: { _id: "$category", firstItem: { $first: "$item" } } }
]);
```
**Keluaran**
```
[
{ "_id" : "food", "firstItem" : "abc" },
{ "_id" : "toy", "firstItem" : "xyz" }
]
```
## Contoh kode
Untuk melihat contoh kode untuk menggunakan `$first` perintah, pilih tab untuk bahasa yang ingin Anda gunakan:
------
#### [ Node.js ]
```
const { MongoClient } = require('mongodb');
async function example() {
const uri = 'mongodb://:@:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false';
const client = new MongoClient(uri);
try {
await client.connect();
const db = client.db('test');
const collection = db.collection('products');
const result = await collection.aggregate([
{ $group: { _id: "$category", firstItem: { $first: "$item" } } }
]).toArray();
console.log(result);
} catch (error) {
console.error('Error:', error);
} finally {
await client.close();
}
}
example();
```
------
#### [ Python ]
```
from pymongo import MongoClient
from pprint import pprint
def example():
client = None
try:
client = MongoClient('mongodb://:@:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false')
db = client['test']
collection = db['products']
result = list(collection.aggregate([
{ '$group': { '_id': '$category', 'firstItem': { '$first': '$item' } } }
]))
pprint(result)
except Exception as e:
print(f"An error occurred: {e}")
finally:
if client:
client.close()
example()
```
------
# \$1floor
Baru dari versi 4.0.
`$floor`Operator di Amazon DocumentDB mengembalikan bilangan bulat terbesar yang kurang dari atau sama dengan nomor yang ditentukan. Operator ini berguna untuk membulatkan nilai numerik.
**Parameter**
+ `expression`: Ekspresi numerik untuk membulatkan ke bawah.
## Contoh (MongoDB Shell)
Contoh berikut menunjukkan penggunaan `$floor` operator untuk membulatkan nilai desimal ke bilangan bulat terdekat.
**Buat dokumen sampel**
```
db.numbers.insertOne({ value: 3.14 });
```
**Contoh kueri**
```
db.numbers.aggregate([
{ $project: { _id: 0, floored: { $floor: "$value" } } }
]);
```
**Keluaran**
```
{ "floored" : 3 }
```
## Contoh kode
Untuk melihat contoh kode untuk menggunakan `$floor` perintah, pilih tab untuk bahasa yang ingin Anda gunakan:
------
#### [ Node.js ]
```
const { MongoClient } = require('mongodb');
async function example() {
const uri = 'mongodb://:@:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false';
const client = new MongoClient(uri);
try {
await client.connect();
const db = client.db('test');
const collection = db.collection('numbers');
const result = await collection.aggregate([
{ $project: { _id: 0, floored: { $floor: "$value" } } }
]).toArray();
console.log(result);
} catch (error) {
console.error('Error:', error);
} finally {
await client.close();
}
}
example();
```
------
#### [ Python ]
```
from pymongo import MongoClient
from pprint import pprint
def example():
client = None
try:
client = MongoClient('mongodb://:@:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false')
db = client.test
collection = db.numbers
result = list(collection.aggregate([
{ '$project': { '_id': 0, 'floored': { '$floor': '$value' }}}
]))
pprint(result)
except Exception as e:
print(f"An error occurred: {e}")
finally:
if client:
client.close()
example()
```
------
# \$1geoNear
Tahap `$geoNear` agregasi mengembalikan dokumen dalam urutan kedekatan dengan titik tertentu. Ini menghitung jarak dari titik dan termasuk jarak dalam dokumen output.
**Parameter**
+ `near`: Titik dari mana untuk menghitung jarak, ditentukan sebagai GeoJSON atau koordinat warisan.
+ `distanceField`: Nama bidang untuk menyimpan jarak yang dihitung.
+ `spherical`: Boolean menunjukkan apakah akan menggunakan geometri bola (diperlukan untuk titik GeoJSON).
+ `maxDistance`: Opsional. Jarak maksimum dari titik pusat.
+ `minDistance`: Opsional. Jarak minimum dari titik pusat.
+ `query`: Opsional. Kriteria filter tambahan untuk diterapkan.
+ `limit`: Opsional. Jumlah maksimum dokumen untuk dikembalikan.
+ `key`: Opsional. Bidang yang akan digunakan untuk kueri geospasial ketika beberapa indeks geospasial ada.
## Contoh (MongoDB Shell)
Contoh berikut menunjukkan menggunakan `$geoNear` panggung untuk menemukan toko terdekat dengan lokasi tertentu.
**Buat dokumen sampel**
```
db.stores.createIndex({ location: "2dsphere" });
db.stores.insertMany([
{ _id: 1, name: "Store A", location: { type: "Point", coordinates: [-122.4, 37.8] } },
{ _id: 2, name: "Store B", location: { type: "Point", coordinates: [-122.5, 37.7] } },
{ _id: 3, name: "Store C", location: { type: "Point", coordinates: [-122.3, 37.9] } }
]);
```
**Contoh kueri**
```
db.stores.aggregate([
{
$geoNear: {
near: { type: "Point", coordinates: [-122.4, 37.8] },
distanceField: "distance",
spherical: true
}
}
]);
```
**Keluaran**
```
[
{ _id: 1, name: 'Store A', location: { type: 'Point', coordinates: [ -122.4, 37.8 ] }, distance: 0 },
{ _id: 3, name: 'Store C', location: { type: 'Point', coordinates: [ -122.3, 37.9 ] }, distance: 13877.82 },
{ _id: 2, name: 'Store B', location: { type: 'Point', coordinates: [ -122.5, 37.7 ] }, distance: 15557.89 }
]
```
## Contoh kode
Untuk melihat contoh kode untuk menggunakan tahap `$geoNear` agregasi, pilih tab untuk bahasa yang ingin Anda gunakan:
------
#### [ Node.js ]
```
const { MongoClient } = require('mongodb');
async function example() {
const client = await MongoClient.connect('mongodb://:@:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false');
const db = client.db('test');
const collection = db.collection('stores');
const result = await collection.aggregate([
{
$geoNear: {
near: { type: "Point", coordinates: [-122.4, 37.8] },
distanceField: "distance",
spherical: true
}
}
]).toArray();
console.log(result);
await client.close();
}
example();
```
------
#### [ Python ]
```
from pymongo import MongoClient
def example():
client = MongoClient('mongodb://:@:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false')
db = client['test']
collection = db['stores']
result = list(collection.aggregate([
{
'$geoNear': {
'near': { 'type': 'Point', 'coordinates': [-122.4, 37.8] },
'distanceField': 'distance',
'spherical': True
}
}
]))
print(result)
client.close()
example()
```
------
# \$1group
Tahap `$group` agregasi di Amazon DocumentDB memungkinkan Anda mengelompokkan dokumen dengan ekspresi tertentu dan melakukan berbagai operasi akumulatif pada data yang dikelompokkan. Ini dapat berguna untuk tugas-tugas seperti menghitung total, rata-rata, atau statistik lain berdasarkan data yang dikelompokkan.
**Parameter**
+ `_id`: Menentukan ekspresi dimana dokumen masukan harus dikelompokkan. Ini bisa berupa nama bidang, ekspresi yang dihitung, atau kombinasi keduanya.
+ `accumulator expressions`: (opsional) Satu atau lebih ekspresi akumulator yang harus diterapkan pada data yang dikelompokkan. Ekspresi ini menggunakan operator akumulator yang disebutkan di atas.
## Contoh (MongoDB Shell)
Contoh berikut mengelompokkan pelanggan berdasarkan kota mereka dan menghitung jumlah total pesanan untuk setiap kota.
**Buat dokumen sampel**
```
db.customers.insertMany([
{ name: "John Doe", city: "New York", orders: [{ amount: 100 }, { amount: 200 }] },
{ name: "Jane Smith", city: "Los Angeles", orders: [{ amount: 150 }, { amount: 300 }] },
{ name: "Bob Johnson", city: "New York", orders: [{ amount: 75 }, { amount: 125 }] },
{ name: "Samantha Lee", city: "Chicago", orders: [{ amount: 50 }, { amount: 100 }] }
]);
```
**Contoh kueri**
```
db.customers.aggregate([
{
$group: {
_id: "$city",
totalOrders: { $sum: { $sum: "$orders.amount" } }
}
}
]);
```
**Keluaran**
```
[
{ _id: 'Chicago', totalOrders: 150 },
{ _id: 'Los Angeles', totalOrders: 450 },
{ _id: 'New York', totalOrders: 500 }
]
```
## Contoh kode
Untuk melihat contoh kode untuk menggunakan `$group` perintah, pilih tab untuk bahasa yang ingin Anda gunakan:
------
#### [ Node.js ]
```
const { MongoClient } = require('mongodb');
async function groupByCity() {
const uri = 'mongodb://:@:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false';
const client = new MongoClient(uri);
try {
await client.connect();
const db = client.db('test');
const result = await db.collection('customers').aggregate([
{ $unwind: '$orders' },
{
$group: {
_id: '$city',
totalOrders: { $sum: '$orders.amount' }
}
}
]).toArray();
console.log(result);
} catch (err) {
console.error('Error during aggregation:', err);
} finally {
await client.close();
}
}
groupByCity();
```
------
#### [ Python ]
```
from pymongo import MongoClient
def group_by_city():
client = MongoClient('mongodb://:@:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false')
try:
db = client.test
result = list(db.customers.aggregate([
{'$unwind': '$orders'},
{
'$group': {
'_id': '$city',
'totalOrders': {'$sum': '$orders.amount'}
}
}
]))
print(result)
except Exception as e:
print(f"Error during aggregation: {e}")
finally:
client.close()
group_by_city()
```
------
# \$1gt
Operator `$gt` agregasi membandingkan dua nilai dan kembali `true` jika nilai pertama lebih besar dari yang kedua, jika tidak kembali. `false`
**Parameter**
+ `expression1`: Nilai pertama untuk membandingkan.
+ `expression2`: Nilai kedua untuk membandingkan.
## Contoh (MongoDB Shell)
Contoh berikut menunjukkan penggunaan `$gt` operator untuk mengidentifikasi produk yang melebihi ambang harga.
**Buat dokumen sampel**
```
db.products.insertMany([
{ _id: 1, name: "Laptop", price: 1200 },
{ _id: 2, name: "Mouse", price: 25 },
{ _id: 3, name: "Monitor", price: 400 }
]);
```
**Contoh kueri**
```
db.products.aggregate([
{
$project: {
name: 1,
price: 1,
expensive: { $gt: ["$price", 100] }
}
}
]);
```
**Keluaran**
```
[
{ _id: 1, name: 'Laptop', price: 1200, expensive: true },
{ _id: 2, name: 'Mouse', price: 25, expensive: false },
{ _id: 3, name: 'Monitor', price: 400, expensive: true }
]
```
## Contoh kode
Untuk melihat contoh kode untuk menggunakan operator `$gt` agregasi, pilih tab untuk bahasa yang ingin Anda gunakan:
------
#### [ Node.js ]
```
const { MongoClient } = require('mongodb');
async function example() {
const client = await MongoClient.connect('mongodb://:@:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false');
const db = client.db('test');
const collection = db.collection('products');
const result = await collection.aggregate([
{
$project: {
name: 1,
price: 1,
expensive: { $gt: ["$price", 100] }
}
}
]).toArray();
console.log(result);
await client.close();
}
example();
```
------
#### [ Python ]
```
from pymongo import MongoClient
def example():
client = MongoClient('mongodb://