データベース Triggers

• Cluster Name。trigger が関連付けられている MongoDB クラスターの名前。

• Database Name。監視対象のコレクションを含む MongoDB database。

• Collection Name。監視する MongoDB コレクション。任意。このオプションを空白のままにすると、ソース タイプは「データベース」に変わります。

• Operation Type。trigger を起動させる操作の種類。trigger が応答する操作のタイプを選択します。オプションは次のとおりです。

  • Insert

  • Update

  • 置換

  • 削除

  注意

  MongoDB Compass または MongoDB Atlas Data Explorer から実行される更新操作は、前のドキュメントを完全に置き換えます。その結果、これらのクライアントからの更新操作では、更新イベントではなく、置換変更イベントが生成されます。

• Full Document。有効な場合、変更が fullDocument フィールドに適用された後、更新変更イベントは、過半数がコミットした最新バージョンの変更ドキュメントを含めます。

  注意

  この設定に関係なく、挿入イベントと置換イベントには常に fullDocument フィールドが含まれます。削除イベントには fullDocument フィールドは含まれません。

• Document Preimage有効にすると、変更イベントには、変更対象のドキュメントに変更が適用される直前のコピーが fullDocumentBeforeChange フィールドに含まれます。これにはパフォーマンス上の考慮事項があります。挿入イベントを除くすべての変更イベントには、ドキュメントのプレイメージが含まれます。

• Cluster Name。trigger が関連付けられている MongoDB クラスターの名前。

• Database Name。監視する MongoDB database。任意。このオプションを空白のままにすると、ソース タイプは "Deployment" に変わります。ただし、共有階層を使用している場合は、Atlas App Services で trigger を保存できません。

• Operation Type。trigger を起動させる操作の種類。trigger が応答する操作のタイプを選択します。オプションは次のとおりです。

  • コレクションを作成

  • コレクションの変更

  • コレクションの名前を変更

  • コレクションの削除

  • コレクションのシャーディング

  • コレクションの再シャーディング

  • コレクションのシャードキーを調整する

  注意

  MongoDB Compass または MongoDB Atlas Data Explorer から実行される更新操作は、前のドキュメントを完全に置き換えます。その結果、これらのクライアントからの更新操作では、更新イベントではなく、置換変更イベントが生成されます。

• Full Document。有効な場合、変更が fullDocument フィールドに適用された後、更新変更イベントは、過半数がコミットした最新バージョンの変更ドキュメントを含めます。

  注意

  この設定に関係なく、挿入イベントと置換イベントには常に fullDocument フィールドが含まれます。削除イベントには fullDocument フィールドは含まれません。

• Document Preimage有効にすると、変更イベントには、変更対象のドキュメントに変更が適用される直前のコピーが fullDocumentBeforeChange フィールドに含まれます。これにはパフォーマンス上の考慮事項があります。挿入イベントを除くすべての変更イベントには、ドキュメントのプレイメージが含まれます。データベース ソースと配置ソースでは無効になっているため、新しいコレクションが作成されるときにクラスターで不要な監視が行われることが制限されます。

• Cluster Name。trigger が関連付けられている MongoDB クラスターの名前。

• Operation Typeトリガーを起動するクラスター内で発生する操作のタイプ。トリガーが応答する操作のタイプを選択します。オプションは次のとおりです。

  • データベースの削除

• Full Document。有効な場合、変更が fullDocument フィールドに適用された後、更新変更イベントは、過半数がコミットした最新バージョンの変更ドキュメントを含めます。

  注意

  この設定に関係なく、挿入イベントと置換イベントには常に fullDocument フィールドが含まれます。削除イベントには fullDocument フィールドは含まれません。

• Document Preimage有効にすると、変更イベントには、変更対象のドキュメントに変更が適用される直前のコピーが fullDocumentBeforeChange フィールドに含まれます。これにはパフォーマンス上の考慮事項があります。挿入イベントを除くすべての変更イベントには、ドキュメントのプレイメージが含まれます。データベース ソースと配置ソースでは無効になっているため、新しいコレクションが作成されるときにクラスターで不要な監視が行われることが制限されます。

有効な場合、この trigger の再開トークンがクラスターの oplog に見つからない場合、trigger は次の関連する変更ストリーム イベントでイベントの情報処理を自動的に再開します。trigger が一時停止されてから trigger が実行を再開するまでのすべての変更ストリーム イベントでは、trigger は起動しません。

有効にすると、trigger イベントは発生順に処理されます。無効にすると、イベントは並列処理されるため、多くのイベントが同時に発生した場合の処理速度が向上します。

イベントの順序付けが有効になっている場合、この trigger は変更イベントのタイムスタンプに基づいて順番に複数回実行されます。イベントの順序付けが無効になっている場合、この trigger の複数回の実行は独立して発生します。

変更ストリーム内の各イベントからフィールドのサブセットを選択する $project 式。これを使用して、trigger の実行を最適化できます。

この式は、変更イベント内のフィールド名を、フィールドを除外する（0）、またはフィールドを含める（1）のいずれかにマップするオブジェクトです。式には、0 または 1 のいずれかの値を指定できますが、両方を指定することはできません。これにより、プロジェクションは包括的と排他的の 2 つのカテゴリに分かれます。

• 包括的なプロジェクト式は、各変更イベント ドキュメントに含めるフィールドを指定します。式は、含めるフィールドの名前を 1 にマッピングするオブジェクトです。フィールドを含めない場合、そのフィールドはプロジェクションされる変更イベントに含まれません。

  例

  次のプロジェクションには、_id フィールドと fullDocument フィールドのみが含まれます。

  {
    _id: 1,
    fullDocument: 1
  }

• 排他的なプロジェクト式は、各変更イベント ドキュメントから除外するフィールドを指定します。式は、含めるフィールドの名前を 0 にマッピングするオブジェクトです。フィールドを除外しない場合、そのフィールドはプロジェクションされる変更イベントに含められます。

  例

  次のプロジェクションには、_id フィールドと fullDocument フィールドが除外されます。

  {
    _id: 0,
    fullDocument: 0
  }

  注意

  プロジェクションで operation_type フィールドを除外することはできません。これにより、trigger は、特定のイベントの操作タイプに対して実行する必要があるかどうかを常に確認できるようになります。

Atlas App Services が trigger の起動を引き起こす変更イベントをフィルタリングするために使用する$match式ドキュメント。 trigger は、受け取るすべての変更イベント オブジェクトをこのマッチ式に対して評価し、特定の変更イベントに対して式がtrueと評価された場合にのみ実行します。

リンクされたデータソースが専用サーバー（M10+ 階層）の場合、最大スループットの同時プロセス数をデフォルトの 10,000 よりも増やすことができます。

最大スループットを増加させる前に、1 つ以上の Triggers がレート制限された外部 API を呼び出しているかどうかを考慮してください。Triggers レートを上げると、これらの制限を超える可能性があります。

スループットを増やすと、ワークロードが大きくなり、クラスター全体のパフォーマンスに影響する可能性があります。