AI エージェント向け: ドキュメントインデックスは https://www.mongodb.com/ja-jp/docs/llms.txt で利用できます。すべてのページの markdown バージョンは、いずれかの URL パスに .md を追加することで利用できます。
Docs Menu

SP.process()(mongoshメソッド)

sp.process()

現在のストリーム プロセシング ワークスペースにエフェメラル ストリーム プロセッサを作成します。

このメソッドは Atlas Stream Processing ワークスペース でサポートされています。

sp.process()メソッドの構文は次のとおりです。

sp.process(
[
<pipeline>
],
{
<options>
}
)

sp.process() 次のフィールドを取ります。

フィールド
タイプ
必要性
説明

pipeline

配列

必須

ストリーム プロセッサがストリーミングデータに適用するストリーム集計パイプライン。

options

オブジェクト

任意

ストリーム プロセッサのオプション設定を定義するオブジェクト。

options.limit

integer

任意

ターミナルに返されるドキュメントの最大数。 sp.process() は、この数のドキュメントを返した後にセッションを終了します。

options.tier

string

任意

ストリーム プロセッサに割り当てる階層。階層名は大文字と小文字を区別しません。このフィールドを省略すると、ストリーム プロセッサはストリーム プロセシング ワークスペースにデフォルトの階層を使用します。次のいずれかの値である必要があります。

  • SP2

  • SP5

  • SP10

  • SP30

  • SP50

詳細については、階層を参照してください。

sp.process() 現在のストリーム処理ワークスペースにエフェメラルの名前のないストリーム プロセッサを作成し、すぐに初期化します。このストリーム プロセッサは実行中のみに保持されます。エフェメラル ストリーム プロセッサを終了する場合、使用するには再度作成する必要があります。

エフェメラル ストリーム プロセッサは、次のいずれかの発生が発生すると停止します。

  • プロセッサは、options.limit によって設定されたドキュメント数を返します。

  • 10 minutes elapse.

  • プロセッサを停止します。

sp.process()を実行中ユーザーには atlasAdmin ロールが必要です。

次の例では、 接続からデータを取り込むエフェメラル ストリームsample_stream_solar プロセッサを作成しています。プロセッサは、 フィールドの値がdevice_id device_810であるすべてのドキュメントを除外し、残りを 秒の期間のローリングウィンドウに渡します。各ウィンドウは受け取ったドキュメントをグループ化し、各グループのさまざまな統計情報を返します。次に、ストリーム プロセッサはこれらのレコードをsolar_db.solar_coll mongodb1接続を介して にマージします。

sp.process(
[
{
$source: {
connectionName: 'sample_stream_solar',
timeField: {
$dateFromString: {
dateString: '$timestamp'
}
}
}
},
{
$match: {
$expr: {
$ne: [
"$device_id",
"device_8"
]
}
}
},
{
$tumblingWindow: {
interval: {
size: Int32(10),
unit: "second"
},
"pipeline": [
{
$group: {
"_id": { "device_id": "$device_id" },
"max_temp": { $max: "$obs.temp" },
"max_watts": { $max: "$obs.watts" },
"min_watts": { $min: "$obs.watts" },
"avg_watts": { $avg: "$obs.watts" },
"median_watts": {
$median: {
input: "$obs.watts",
method: "approximate"
}
}
}
}
]
}
},
{
$merge: {
into: {
connectionName: "mongodb1",
db: "solar_db",
coll: "solar_coll"
},
on: ["_id"]
}
}
]
)