MongoDB（バージョン 2）

MongoDB コネクタを使用すると、MongoDB データベースに対して挿入、削除、更新、読み取りオペレーションを実行できます。

サポート対象のバージョン

MongoDB バージョン 3.6～6.1
Google Cloud にデプロイされた Mongo Atlas。

準備

MongoDB コネクタを使用する前に、次の作業を行います。

Google Cloud プロジェクトで次の操作を行います。
- ネットワーク接続が設定されていることを確認します。ネットワークパターンの詳細については、Network Connectivity をご覧ください。
- コネクタを構成するユーザーに roles/connectors.admin IAM ロールを付与します。
- コネクタに使用するサービスアカウントに、次の IAM ロールを付与します。
  - roles/secretmanager.viewer
  - roles/secretmanager.secretAccessor
  サービスアカウントは特別なタイプの Google アカウントで、Google API のデータにアクセスするのに認証を受ける必要がある人間以外のユーザーを表します。サービスアカウントがない場合は、サービスアカウントを作成する必要があります。詳細については、サービスアカウントを作成するをご覧ください。
- 次のサービスを有効にします。
  - secretmanager.googleapis.com（Secret Manager API）
  - connectors.googleapis.com（Connectors API）
  サービスを有効にする方法については、サービスを有効にするをご覧ください。
以前にプロジェクトでこうしたサービスを有効にしていない場合は、コネクタを構成するときにそれを有効にすることを求められます。

コネクタを構成する

コネクタを構成するには、データソース（バックエンドシステム）への接続を作成する必要があります。接続はデータソースに特有です。つまり、多数のデータソースがある場合は、データソースごとに別々の接続を作成する必要があります。接続を作成する手順は次のとおりです。

Cloud コンソールで、[Integration Connectors] > [接続] ページに移動し、Google Cloud プロジェクトを選択または作成します。
[接続] ページに移動
[+ 新規作成] をクリックして [接続の作成] ページを開きます。
[ロケーション] セクションで、接続のロケーションを選択します。
1. リージョン: プルダウンリストからロケーションを選択します
  サポートされているすべてのリージョンの一覧については、ロケーションをご覧ください。
2. [次へ] をクリックします。
[接続の詳細] セクションで、次の操作を行います。
1. コネクタ: 使用可能なコネクタのプルダウンリストから [MongoDB] を選択します。
2. コネクタのバージョン: 使用可能なバージョンのプルダウンリストからバージョン 2（2）を選択します。
3. [接続名] フィールドに、接続インスタンスの名前を入力します。
  接続名は次の条件を満たす必要があります。
  - 接続名には英字、数字、ハイフンを使用できます。
  - 文字は小文字のみを使用できます。
  - 接続名の先頭には英字を設定し、末尾には英字または数字を設定する必要があります。
  - 接続名は 49 文字以内で指定してください。
4. 必要に応じて、接続インスタンスの [説明] を入力します。
5. 必要に応じて、Cloud Logging を有効にして、ログレベルを選択します。デフォルトのログレベルは Error に設定されています。
6. サービスアカウント: 必要なロールを持つサービスアカウントを選択します。
7. 必要に応じて、接続ノードの設定を構成します。
  - ノードの最小数: 接続ノードの最小数を入力します。
  - ノードの最大数: 接続ノードの最大数を入力します。
  ノードは、トランザクションを処理する接続の単位（またはレプリカ）です。1 つの接続でより多くのトランザクションを処理するには、より多くのノードが必要になります。逆に、より少ないトランザクションを処理するには、より少ないノードが必要になります。ノードがコネクタの料金に与える影響については、接続ノードの料金をご覧ください。値を入力しない場合は、デフォルトで最小ノード数は 2 に設定され（可用性を高めるため）、最大ノード数は 50 に設定されます。
8. データベース: MongoDB データベースの名前。
9. Connection Timeout: 接続タイムアウト（秒）。
10. SSL を使用: SSL を有効にするかどうかを指定します。
11. アプリ名: Mongo のカスタムアプリ名。
12. 最大ステイルネス秒: クライアントが読み取りオペレーションでの使用を停止するまでに、セカンダリが古くなるまでの時間（秒）。
13. 書き込みの問題（w オプション）: 特定のタグを持つ指定された数のインスタンスへ書き込みオペレーションが伝播されたことを示す確認応答をリクエストするオプション。
14. 書き込みの問題（wtimeoutMS オプション）: 書き込みに関する制限時間をミリ秒単位で指定します。
15. 書き込みの問題（journal オプション）: 書き込みオペレーションがジャーナルに書き込まれたという確認応答を MongoDB にリクエストします。
16. 読み取りの設定: レプリカセットからの読み取りの方針を設定します。設定可能な値は、primary、primaryPreferred、secondary、secondaryPreferred、nearest です。
17. クラスタタイプ: MongoDB クラスタのタイプを指定します。
18. 暗号化を有効にする: 暗号化を有効にするかどうかを指定します。
19. 暗号化タイプ: 有効にする暗号化のタイプを指定します。現在、Local Encryption タイプのみがサポートされています。
20. 暗号化スキーマ: フィールドと暗号化アルゴリズム、鍵の代替名、クエリの種類、競合要因など、暗号化スキーマの情報を指定します。次に例を示します。
```
{
  "database.collection": {
    "encryptMetadata": {
      "algorithm": "parentAlgo"
    },
    "properties": {
      "passportId": {},
      "medicalRecords": {
        "encryptMetadata": {
          "algorithm": "medicalRecordParentAlgo"
        },
        "properties": {
          "medicalRecord1": {},
          "medicalRecord2": {
            "encrypt": {
              "algorithm": "medicalRecord2Algo",
              "keyAltName": "medicalRecord2Altkey",
              "queryType": "equality",
              "contentionFactor": 3
            }
          }
        }
      },
      "insuranceProperties": {
        "properties": {
          "policyNumber": {},
          "insuranceRecord1": {
            "encrypt": {
              "algorithm": "insuranceRecord1Algo",
              "keyAltName": "insuranceRecord1AltKey"
            }
          },
          "insuranceRecord2": {
            "encrypt": {
              "algorithm": "insuranceRecord2Algo",
              "keyAltName": "insuranceRecord2AltKey",
              "contentionFactor": 5
            }
          }
        }
      }
    }
  }
}
```
21. encryption_master_key: 暗号マスター鍵を含む Secret Manager のシークレット。
22. encryption_key_vault: 暗号化鍵の Vault の値。
23. Auth Database: 認証用の MongoDB データベースの名前の特定。
24. 必要に応じて、[+ ラベルを追加] をクリックして Key-Value ペアの形式でラベルを接続に追加します。
25. [NEXT] をクリックします。
[宛先] セクションに、接続するリモートホスト（バックエンドシステム）の詳細を入力します。
1. 宛先タイプ: 宛先の詳細はホストアドレスとして指定できます。ホストアドレスは次のいずれかの値になります。
  - 単一の Mongo SRV 文字列。例: mongodb+srv://cluster2.2f.mongodb.net
  - 個々のレプリカ。例: dasdsf.2f.mongodb01.net
  - IP アドレス。例えば、10.23.123.12です。
  mongodb+srv が指定されていない場合、接続文字列内のすべてのレプリカが結合された後、mongodb:// 接頭辞が最終 URL に追加されます。
  - ホストアドレス: 宛先のホスト名または IP アドレスを指定します。
    バックエンドへのプライベート接続を確立する場合は、次のようにします。
    - PSC サービスアタッチメントを作成します。
    - エンドポイントアタッチメントを作成し、続いて [Host address] フィールドにあるエンドポイントアタッチメントの詳細を入力します。
    注: Google Cloud 内のプライベートネットワークで実行されている MongoDB Atlas クラスタに接続する場合は、Atlas クラスタのプライベート接続性をご覧ください。
  他の宛先を入力するには、[+ 宛先を追加] をクリックします。
2. [NEXT] をクリックします。
[認証] セクションで、認証の詳細を入力します。
1. [認証タイプ] を選択し、関連する詳細を入力します。
  MongoDB 接続でサポートされる認証タイプは次のとおりです。
  - ユーザー名とパスワードを指定する
2. [NEXT] をクリックします。
Review: 接続と認証の詳細を確認します。
[作成] をクリックします。

認証を構成する

使用する認証に基づいて詳細を入力します。

ユーザー名とパスワード 　　　　　　　　　　　　　　　　
- ユーザー名: コネクタのユーザー名
- パスワード: ユーザーのパスワードを含む Secret Manager のシークレット。
- Auth Scheme: 認証に使用されるスキーム
  MongoDB 接続でサポートされる認証スキームは次のとおりです。
  - Plain
  - SCRAM-SHA-1
  - SCRAM-SHA-256

エンティティ、オペレーション、アクション

すべての Integration Connectors が、接続されたアプリケーションのオブジェクトを抽象化するレイヤを提供します。アプリケーションのオブジェクトには、この抽象化を通じてのみアクセスできます。抽象化は、エンティティ、オペレーション、アクションとして公開されます。

エンティティ: エンティティは、接続されているアプリケーションやサービスのオブジェクト、またはプロパティのコレクションと考えることができます。エンティティの定義は、コネクタによって異なります。たとえば、データベースコネクタでは、テーブルがエンティティであり、ファイルサーバーコネクタでは、フォルダがエンティティです。また、メッセージングシステムコネクタでは、キューがエンティティです。
ただし、コネクタでいずれのエンティティもサポートされていない、またはエンティティが存在しない可能性があります。その場合、Entities リストは空になります。
オペレーション: エンティティに対して行うことができるアクティビティです。エンティティに対して次のいずれかのオペレーションを行うことができます。
- リスト
- 取得
- 作成
- 更新
- 削除
使用可能なリストからエンティティを選択すると、そのエンティティで使用可能なオペレーションのリストが生成されます。オペレーションの詳細については、コネクタタスクのエンティティオペレーションをご覧ください。ただし、コネクタがいずれかのエンティティオペレーションをサポートしていない場合、サポートされていないオペレーションは Operations リストに含まれません。
アクション: コネクタインターフェースを介して統合で使用できる主要な関数の一つです。アクションを使用すると、1 つまたは複数のエンティティに対して変更を加えることができます。また、使用できるアクションはコネクタごとに異なります。通常、アクションには入力パラメータと出力パラメータがあります。ただし、コネクタがどのアクションもサポートしていない可能性があります。その場合は、Actions リストが空になります。

システムの上限

MongoDB コネクタは、ノードごとに 1 秒あたり最大 70 件のトランザクションを処理することができ、この上限を超えるトランザクションはすべてthrottlesされます。デフォルトでは、Integration Connectors は、接続に 2 つのノードを割り当てます（可用性を高めるため）。

Integration Connectors に適用される上限の詳細については、上限をご覧ください。

注: Integration Connectors ノードの数は、使用状況に応じて動的に自動スケーリングされます。ただし、自動スケーリングを待たずに大量の容量を確保する場合は、接続の最小ノード値を調整できます。1 つの接続により多くのトランザクションを処理するには、より多くのノードが必要です。逆に、接続が処理するトランザクションが少ない場合は、必要なノードの数が少なくなります。ノードの値を構成するには、次の手順を行います。

従量課金制をご利用のお客様は、接続の編集ページでノードの最小値と最大値を構成します。
サブスクリプションベースで利用されているお客様は、サポートにお問い合わせください。

ノードが処理できる最大トランザクションは、さまざまな要因によって異なります。そのため、スループットを高めるために最小ノードを調整する前に、バックエンドシステムが必要なトラフィックを処理するために最適に設定されているかどうかを確認することをおすすめします。

サポートされているデータ型

このコネクタでサポートされているデータ型は次のとおりです。

BIGINT
BINARY
BIT
BOOLEAN
CHAR
DATE
DECIMAL
DOUBLE
FLOAT
INTEGER
LONGN VARCHAR
LONG VARCHAR
NCHAR
NUMERIC
NVARCHAR
REAL
SMALL INT
TIME
TIMESTAMP
TINY INT
VARBINARY
VARCHAR

MongoDB Atlas クラスタの構成

MongoDB Atlas クラスタの認証構成は、以前に文書化された手順とは少し異なります。Atlas クラスタに対して認証を行うには、まず Atlas 接続文字列を取得する必要があります。Atlas 接続文字列を取得するには、次の手順を行います。

[クラスタ] ビューで、接続するクラスタの [接続] をクリックします。
[アプリケーションを接続] をクリックします。
いずれかのドライバオプションを選択して、接続文字列を表示します。

Atlas クラスタに対して認証を行うには、次の構成を使用します。

Auth Database: すべての MongoDB Atlas ユーザーが admin データベースに関連付けられているため、値を admin に設定します。
Use SSL: 値を true に設定します。
サーバー: ユーザー名とパスワードを含めずに、値を mongodb+srv://MongoDB INSTANCE SERVER NAME に設定します。

アクション

このセクションでは、MongoDB 接続でサポートされているすべてのアクションを一覧表示します。

注: すべてのアクションの結果は、統合を実行した後に Connectors タスクの connectorOutputPayload レスポンスパラメータで JSON レスポンスとして利用できます。

AggregatePipeline アクション

このアクションは、コレクション内のパイプラインの変更を集計します。

AggregatePipeline アクションの入力パラメータ

パラメータ名	データ型	必須	説明
コレクション	文字列	はい	MongoDB コレクションの名前。
pipeline	文字列	はい	フィールドステージを文字列のリストとして含む集計パイプライン。
page_size	整数	いいえ	結果セットの各ページに含めるアイテムの数。
page_no	整数	いいえ	結果セットから取得するページのインデックス。インデックスは 0 から始まります。

AggregatePipeline アクションの構成例については、例をご覧ください。

CountDocuments アクション

このアクションは、コレクション内の指定された条件を満たすすべてのドキュメントをカウントします。

CountDocuments アクションの入力パラメータ

パラメータ名	データ型	必須	説明
コレクション	文字列	はい	MongoDB コレクションの名前。
filter	文字列	いいえ	MongoDB クエリ形式で表されたフィルタ条件。クエリタイプの等価性に対して暗号化スキーマが有効になっている場合、この条件に暗号化されたフィールドを含めることができます。

CountDocuments アクションの出力パラメータ

このアクションは、指定された条件を満たすすべてのドキュメントの数を返します。

CountDocuments アクションの構成例については、例をご覧ください。

DeleteDocuments アクション

このアクションは、コレクション内のドキュメントを削除します。

DeleteDocuments アクションの入力パラメータ

パラメータ名	データ型	必須	説明
コレクション	文字列	はい	MongoDB コレクションの名前。
filter	文字列	いいえ	MongoDB クエリ形式で表されたフィルタ条件。クエリタイプの等価性に対して暗号化スキーマが有効になっている場合、この条件に暗号化されたフィールドを含めることができます。

DeleteDocuments アクションの出力パラメータ

このアクションは、削除されたドキュメントの数を返します。

DeleteDocuments アクションの構成例については、例をご覧ください。

DistinctValues アクション

このアクションは、コレクション内のフィールドの個別の値を返します。

DistinctValues アクションの入力パラメータ

パラメータ名	データ型	必須	説明
コレクション	文字列	はい	MongoDB コレクションの名前。
フィールド	文字列	はい	個別の値をクエリするフィールド名。
filter	文字列	いいえ	MongoDB クエリ形式で表されたフィルタ条件。クエリタイプの等価性に対して暗号化スキーマが有効になっている場合、この条件に暗号化されたフィールドを含めることができます。

DistinctValues アクションの構成例については、例をご覧ください。

InsertDocument アクション

このアクションは、コレクションにドキュメントを挿入します。

次の表に、InsertDocument アクションの入出力パラメータを示します。

InsertDocument アクションの入力パラメータ

パラメータ名	データ型	必須	説明
コレクション	文字列	はい	MongoDB コレクションの名前。
ドキュメント	文字列	いいえ	MongoDB コレクションに追加するドキュメント。

InsertDocument アクションの出力パラメータ

このアクションは、挿入されたドキュメントの ID を返します。

InsertDocument アクションの構成例については、例をご覧ください。

ListDocuments アクション

次の表に、ListDocuments アクションの入出力パラメータを示します。

ListDocuments アクションの入力パラメータ

パラメータ名	データ型	必須	説明
コレクション	文字列	はい	MongoDB コレクションの名前。
filter	文字列	いいえ	MongoDB クエリ形式で表されたフィルタ条件。クエリタイプの等価性に対して暗号化スキーマが有効になっている場合、この条件に暗号化されたフィールドを含めることができます。
page_size	整数	いいえ	結果セットの各ページに含めるアイテムの数。
page_no	整数	いいえ	結果セットから取得するページのインデックス。インデックスは 0 から始まります。
projection	文字列	いいえ	Mongo 形式のクエリプロジェクションに含まれるフィールドまたはプロパティのセット。
sort_by	文字列	いいえ	MongoDB のバイナリ JSON（BSON）形式を使用したクエリ結果の並べ替えの仕様。

ListDocuments アクションの出力パラメータ

このアクションは、ページサイズに従ってフィルタ条件を満たすドキュメントのリストを返します。デフォルトのページサイズは 25 で、最大ページサイズは 50,000 です。

ListDocuments アクションの構成例については、例をご覧ください。

UpdateDocuments アクション

次の表に、UpdateDocuments アクションの入出力パラメータを示します。

UpdateDocuments アクションの入力パラメータ

パラメータ名	データ型	必須	説明
コレクション	文字列	はい	MongoDB コレクションの名前。
値	文字列	いいえ	Mongo 形式で更新する値。
filter	文字列	いいえ	MongoDB クエリ形式で表されたフィルタ条件。クエリタイプの等価性に対して暗号化スキーマが有効になっている場合、この条件に暗号化されたフィールドを含めることができます。
upsert	ブール値	いいえ	オペレーションが upsert かどうか。

UpdateDocuments アクションの出力パラメータ

このアクションは、更新されたドキュメントの数を返します。

UpdateDocuments アクションの構成例については、例をご覧ください。

UpdateDocumentsWithEncryption アクション

このアクションを使用すると、ユーザーは暗号化された値を更新できます。次の表に、UpdateDocumentsWithEncryption アクションの入出力パラメータを示します。

UpdateDocumentsWithEncryption アクションの入力パラメータ

パラメータ名	データ型	必須	説明
コレクション	文字列	はい	MongoDB コレクションの名前。
ドキュメント	文字列	いいえ	更新する値を含むドキュメント。値には、CSFLE を使用して暗号化されるフィールドを含めることができます。
filter	文字列	いいえ	MongoDB クエリ形式で表されたフィルタ条件。クエリタイプの等価性に対して暗号化スキーマが有効になっている場合、この条件に暗号化されたフィールドを含めることができます。
upsert	ブール値	いいえ	オペレーションが `upsert` かどうかを指定します。

UpdateDocumentsWithEncryption アクションの出力パラメータ

このアクションは、更新されたドキュメントの数を返します。

UpdateDocumentsWithEncryption アクションの構成例については、例をご覧ください。

例

このセクションでは、このコネクタでエンティティオペレーションとアクションの一部を実行する方法について説明します。

例 - パイプラインの変更を集計する

[Configure connector task] ダイアログで、[Actions] をクリックします。
[AggregatePipeline] アクションを選択してから、[完了] をクリックします。

[コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。

{
  "collection": "restaurants",
  "pipeline": {
    "stages": [
      "{$addFields: { \"new_menu_item\": \"tea\"}}"
    ]
  },
  "page_size": 1,
  "page_no": 0
}

この例では、restaurant コレクション内のすべてのドキュメントに新しいメニュー項目を追加し、結果の最初のページを返します。

例 - ドキュメントの数をカウントする

[Configure connector task] ダイアログで、[Actions] をクリックします。
[CountDocuments] アクションを選択してから、[完了] をクリックします。
[コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。
```
{
"collection":"restaurants",
"filter": "{\"name\": \"CarvelIceCream1\"}"
}
```

この例では、フィルタ条件に一致するドキュメントの数を返します。アクションが成功すると、Connectors タスクの connectorOutputPayload レスポンスパラメータの値は次のようになります。

{
  "results": [
   {
    "count": 5
   }
  ]
}

例 - ドキュメントを削除する

[Configure connector task] ダイアログで、[Actions] をクリックします。
[DeleteDocuments] アクションを選択してから、[完了] をクリックします。
[コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のように入力します。
```
{
  "collection": "Insurancedocuments",
  "filter": "{\"insurance.provider\":\"ABC\"}"}
```

この例では、保険会社が ABC であるすべてのドキュメントを削除します。

例 - コレクション内の個別の値を検索する

[Configure connector task] ダイアログで、[Actions] をクリックします。
[DistinctValues] アクションを選択してから、[完了] をクリックします。
[コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。
```
{"collection":"restaurants","field":"contact"}
```

この例では、restaurants コレクション内の個別の値が返されます。アクションが成功すると、Connectors タスクの connectorOutputPayload レスポンスパラメータの値は次のようになります。

{
 "results": [
  {
   "DistinctValues": [
    "3217902323",
    "8747479023",
    "3492619023"
   ]
  }
 ]
}

例 - ドキュメントを挿入する

[Configure connector task] ダイアログで、[Actions] をクリックします。
[InsertDocument] アクションを選択してから、[完了] をクリックします。

[コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。

{ {
"collection": "Insurancedocuments",
"document": "{\"fname\":\"firstName\",
\"lname\":\"lastName\",
\"passportId\":\"ABCD1234\",
\"bloodType\":\"A\",
\"medicalRecords\":[{\"item\":\"name1\"},{\"item\":\"name2\"}],
\"insurance\":{\"policyNumber\":\"12345\",\"provider\":\"provider2\"}}"
} }

この例では、Insurancedocuments コレクションにドキュメントを挿入します。ドキュメントの内容は document フィールドで指定します。挿入が成功すると、Connectors タスクの connectorOutputPayload レスポンスパラメータに挿入されたドキュメントの ID が返されます。

例 - ドキュメントを一覧表示する

[Configure connector task] ダイアログで、[Actions] をクリックします。
[ListDocuments] アクションを選択してから、[完了] をクリックします。
[コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。
```
{
"collection": "Insurancedocuments",
"filter": "{\"insurance.provider\":\"ABC\"}",
"page_size": 10
}
```

この例では、保険会社が ABC である Insurancedocuments コレクション内のドキュメントを返します。結果セットのページサイズは 10 に設定され、ファイルのリストは Connectors タスクの connectorOutputPayload レスポンスパラメータで JSON 形式で利用できます。

例 - ドキュメントを更新する

[Configure connector task] ダイアログで、[Actions] をクリックします。
[UpdateDocuments] アクションを選択してから、[完了] をクリックします。
[コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。
```
{"collection":"Insurancedocuments",
"values":" {$set: { lname:\"Smith\" }}",
"filter":"{\"insurance.provider\":\"ABC\"}"}
```

この例では、フィルタ条件に一致するドキュメントの姓を Smith に更新します。更新が正常に完了すると、更新されたドキュメントの数が表示されます。レスポンスは、Connectors タスクの connectorOutputPayload レスポンスパラメータで使用できます。

例 - 暗号化を使用してドキュメントを更新する

[Configure connector task] ダイアログで、[Actions] をクリックします。
[UpdateDocumentsWithEncryption] アクションを選択してから、[完了] をクリックします。
[コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のように入力します。
```
{ {"collection":"Insurancedocuments",
"document":" { \"insurance.provider\":\"XYZ\" }",
"filter":"{\"insurance.provider\":\"ABC\"}"}
```

この例では、保険会社が ABC であるすべてのドキュメントで、保険会社を XYZ に更新します。

Terraform を使用して接続を作成する

Terraform リソースを使用して、新しい接続を作成できます。

Terraform 構成を適用または削除する方法については、基本的な Terraform コマンドをご覧ください。

接続作成用の Terraform テンプレートのサンプルを表示するには、サンプルテンプレートをご覧ください。

Terraform を使用してこの接続を作成する場合は、Terraform 構成ファイルで次の変数を設定する必要があります。

パラメータ名	データ型	必須	説明
データベース	STRING	True	MongoDB データベースの名前。
timeout	INTEGER	False	接続タイムアウト（秒）。
enable_ssl	BOOLEAN	False	このフィールドは SSL を有効にするかどうかを設定します。
app_name	STRING	False	MongoDB のカスタムアプリ名。
max_staleness_seconds	INTEGER	False	セカンダリの古さを示す時間（秒）。クライアントが、読み取りオペレーションにセカンダリの使用を停止するまでの時間です。
write_concern	STRING	False	書き込みオペレーションが、指定されたタグを持つ指定された数のインスタンスに対して伝播されたことの確認をリクエストするオプション。
write_concern_timeout	INTEGER	False	書き込みに関する制限時間をミリ秒単位で指定します。
write_concern_journal	BOOLEAN	False	書き込みオペレーションがジャーナルに書き込まれたという確認応答を MongoDB にリクエストします。
read_preference	ENUM	False	この接続の読み取り優先度。サポートされている値は、primary、primaryPreferred、secondary、secondaryPreferred、nearest です。
cluster_type	ENUM	False	MongoDB クラスタのタイプを指定します。サポートされている値は、REPLICA_SET、STANDALONE、SHARDED、UNKNOWN です。
enable_encryption	BOOLEAN	False	このフィールドでは、暗号化を有効にするかどうかを設定します。
encryption_type	ENUM	False	このフィールドでは、有効にする暗号化のタイプを設定します。サポートされている値は、local です。
encryption_schema	STRING	False	暗号化スキーマの情報（使用するフィールドや暗号化アルゴリズムなど）。
encryption_master_key	SECRET	False	暗号マスター鍵を含む Secret Manager のシークレット。
encryption_key_vault	STRING	False	暗号化鍵の Vault の値。
auth_database	STRING	True	認証用の MongoDB データベースの名前。

統合で MongoDB　接続を使用する

接続を作成すると、Apigee Integration と Application Integration の両方で使用できるようになります。この接続は、コネクタタスクを介して統合で使用できます。

Apigee Integration で Connectors タスクを作成して使用する方法については、Connectors タスクをご覧ください。
Application Integration で Connectors タスクを作成して使用する方法については、Connectors タスクをご覧ください。

Google Cloud コミュニティの助けを借りる

Google Cloud コミュニティの Cloud フォーラムで質問を投稿したり、このコネクタについてディスカッションしたりできます。

MongoDB（バージョン 2）

サポート対象のバージョン

準備

コネクタを構成する

認証を構成する

エンティティ、オペレーション、アクション

システムの上限

サポートされているデータ型

MongoDB Atlas クラスタの構成

アクション

AggregatePipeline アクション

AggregatePipeline アクションの入力パラメータ

CountDocuments アクション

CountDocuments アクションの入力パラメータ

CountDocuments アクションの出力パラメータ

DeleteDocuments アクション

DeleteDocuments アクションの入力パラメータ

DeleteDocuments アクションの出力パラメータ

DistinctValues アクション

DistinctValues アクションの入力パラメータ

InsertDocument アクション

InsertDocument アクションの入力パラメータ

InsertDocument アクションの出力パラメータ

ListDocuments アクション

ListDocuments アクションの入力パラメータ

ListDocuments アクションの出力パラメータ

UpdateDocuments アクション

UpdateDocuments アクションの入力パラメータ

UpdateDocuments アクションの出力パラメータ

UpdateDocumentsWithEncryption アクション

UpdateDocumentsWithEncryption アクションの入力パラメータ

UpdateDocumentsWithEncryption アクションの出力パラメータ

例

例 - パイプラインの変更を集計する

例 - ドキュメントの数をカウントする

例 - ドキュメントを削除する

例 - コレクション内の個別の値を検索する

例 - ドキュメントを挿入する

例 - ドキュメントを一覧表示する

例 - ドキュメントを更新する

例 - 暗号化を使用してドキュメントを更新する

Terraform を使用して接続を作成する

統合で MongoDB 接続を使用する

Google Cloud コミュニティの助けを借りる

次のステップ

統合で MongoDB　接続を使用する