/ /

Atlas Stream Processing

Docs Home

/ /

mongosh メソッド

Atlas Stream Processing

Atlas Stream Processing

SP.createStreamProcessor()（mongoshメソッド）

定義

sp.createStreamProcessor()

現在のストリームプロセシングワークスペースに Stream プロセッサを作成します。

このコマンドは、ストリーム処理ワークスペースに接続しているときにのみ呼び出せます。

このコマンドには、 mongoshバージョン `` 2.0が必要です。

互換性

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

構文

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

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

コマンドフィールド

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

フィールド	タイプ	必要性	説明
`name`	string	必須	ストリームプロセッサの論理名。これは、ストリーム処理ワークスペース内で一意である必要があります。
`pipeline`	配列	必須	データのストリーミング配信に適用するストリーム集約パイプライン。
`options`	オブジェクト	任意	ストリームプロセッサのさまざまなオプション設定を定義するオブジェクト。
`options.dlq`	オブジェクト	条件付き	ストリーム処理ワークスペースにデッドレターキュー (DLQ)を割り当てるオブジェクト。このフィールドは、`options`フィールドを定義する場合に必要です。
`options.dlq.connectionName`	string	条件付き	接続レジストリ内の接続を識別するラベル。この接続は Atlas クラスターを参照する必要があります。このフィールドは、 `options.dlq`フィールドを定義する場合に必要です。
`options.dlq.db`	string	条件付き	`options.dlq.connectionName`で指定されたクラスター上の Atlas データベースの名前。このフィールドは、 `options.dlq`フィールドを定義する場合に必要です。
`options.dlq.coll`	string	条件付き	`options.dlq.db`で指定されるデータベース内のコレクションの名前。このフィールドは、 `options.dlq`フィールドを定義する場合に必要です。
`options.tier`	string	任意	Atlas Stream Processing がプロセッサを割り当てる階層。このオプションを宣言しない場合、Atlas Stream Processing はプロセッサを Stream Processing ワークスペースの階層に割り当てます。次のいずれかである必要があります。 `SP2` `SP5` `SP10` `SP30` `SP50` 詳細については、階層を参照してください。

動作

sp.createStreamProcessor() は、現在のストリーム処理ワークスペースに永続的な名前付きストリームプロセッサを作成します。このストリームプロセッサは sp.processor.start() で初期化できます。既存のストリームプロセッサと同じ名前でストリームプロセッサを作成しようとすると、mongosh はエラーを返します。

アクセス制御

sp.createStreamProcessor()を実行しているユーザーにはatlasAdminロールが必要です。

例

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

sp.createStreamProcessor(
  'solarDemo',
  [
    {
      $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"]
      }
    }
  ]
)

詳細

戻る

Atlas Stream Processing

SP.listConnections