$slice（集計）

項目一覧

定義

動作
例

MongoDB5.0 は 10 月2024 をもってサポートを終了します。このバージョンのドキュメントはサポート対象外になりました。配置をアップグレードするには、 MongoDB を参照してください。5.0 60アップグレード手順。

定義

$slice

バージョン 3.2 で追加。

配列のサブセットを返します。

$slice 次の 2 つの構文形式のいずれかがあります。

次の構文は、配列の先頭または末尾から要素を返します。

{ $slice: [ <array>, <n> ] }

次の構文は、配列内の指定された位置から要素を返します。

{ $slice: [ <array>, <position>, <n> ] }

オペランド	説明
`<array>`	配列に変換される任意の有効な式。
`<position>`	任意。整数に変換される限り、任意の有効な式。正の場合、`$slice` は配列の先頭から開始位置を決定します。`<position>`が要素数より大きい場合、`$slice` は空の配列を返します。負の場合、`$slice` は配列の末尾から開始位置を決定します。`<position>` の絶対値が要素数より大きい場合、開始位置は配列の先頭になります。
`<n>`	整数に変換される限り、任意の有効な式。`<position>` が指定されている場合、`<n>` は、正の整数に解決される必要があります。正の場合、`$slice` は配列内の最初の`n` 要素までを返します。`<position>`が指定されている場合、`$slice` `n`はその位置から始まる最初の要素を返します。負の場合、`$slice` は配列内の最後の`n` 要素までを返します。`n`が指定されている場合、`<position>` は負の数に解決されません。

式の詳細については、「式」を参照してください。

動作

例

結果

{ $slice: [ [ 1, 2, 3 ], 1, 1 ] }

[ 2 ]

{ $slice: [ [ 1, 2, 3 ], -2 ] }

[ 2, 3 ]

{ $slice: [ [ 1, 2, 3 ], 15, 2 ] }

[  ]

{ $slice: [ [ 1, 2, 3 ], -15, 2 ] }

[ 1, 2 ]

例

users という名前のコレクションには次のドキュメントが含まれています。

{ "_id" : 1, "name" : "dave123", favorites: [ "chocolate", "cake", "butter", "apples" ] }
{ "_id" : 2, "name" : "li", favorites: [ "apples", "pudding", "pie" ] }
{ "_id" : 3, "name" : "ahn", favorites: [ "pears", "pecans", "chocolate", "cherries" ] }
{ "_id" : 4, "name" : "ty", favorites: [ "ice cream" ] }

次の例では、各ユーザーの favorites 配列の最初の 3 つの要素が返されます。

db.users.aggregate([
   { $project: { name: 1, threeFavorites: { $slice: [ "$favorites", 3 ] } } }
])

この操作は次の結果を返します。

{ "_id" : 1, "name" : "dave123", "threeFavorites" : [ "chocolate", "cake", "butter" ] }
{ "_id" : 2, "name" : "li", "threeFavorites" : [ "apples", "pudding", "pie" ] }
{ "_id" : 3, "name" : "ahn", "threeFavorites" : [ "pears", "pecans", "chocolate" ] }
{ "_id" : 4, "name" : "ty", "threeFavorites" : [ "ice cream" ] }

戻る

$sinh

$split