MongoDB (プレビュー)
MongoDB は、開発者に愛され、さまざまなワークロードを実行するために企業全体で使用される、汎用の分散型ドキュメント データ プラットフォームです。MongoDB コネクタを使用して、さまざまなエンドポイントを探索し、コレクションに対して CRUD 操作と集計を実行できるようになりました。
このコネクタは、次の製品および地域で利用可能です:
| Service | クラス | 地域 |
|---|---|---|
| Logic Apps | 標準 | 以下を除くすべての Logic Apps 地域 : - Azure 政府の地域 - Azure 中国の地域 - 国防総省 (DoD) |
| Power Automate | プレミアム | 以下を除くすべての Power Automate 地域 : - 米国政府 (GCC) - 米国政府 (GCC High) - 21 Vianet が運用する中国のクラウド - 米国国防総省 (DoD) |
| Power Apps | - | 該当なし |
| お問い合わせ先 | |
|---|---|
| 件名 | MongoDB サポート |
| [URL] | https://www.mongodb.com/community/forums/ |
| メール | support-operations@mongodb.com |
| Connector Metadata | |
|---|---|
| 発行者 | MongoDB |
| Web サイト | https://www.mongodb.com |
| プライバシー ポリシー | https://www.mongodb.com/legal/privacy-policy |
| カテゴリー | 日付 |
MongoDB コネクタは、Atlas Data API を介して MongoDB Atlas に接続し、MongoDB Atlas コレクションにデータを読み書きする簡単な方法を提供します。 MongoDB コネクタを使用すると、データの CRUD 操作と集計を数分で簡単に実行でき、MongoDB にクエリを実行して豊富なアプリとワークフローを Power Apps と Power Automate で構築できます。
前提条件
- Atlas 環境を構成する
新しい Atlas アカウントは こちら で登録します。 手順 1 ～ 4 (Atlas アカウントの作成、無料クラスターのデプロイ、IP アクセス リストへの IP の追加、データベース ユーザーの作成) に従って、Atlas 環境をセットアップします。
- Atlas で Data API を有効にするのは こちら。
Data API Access ドロップダウンで、Read And Write オプションを選択します。
後の段階で使用する URL エンドポイントを保存します。
- Data API Key の作成は こちら
注: 完全な秘密鍵を取得できるのはこのときだけなので、生成された API キーを保存してください
資格情報の入手方法
Data API キーの作成 の手順に従って、Atlas で API キーを作成し、API 呼び出しで使用します
コネクタの使用を開始する
前提条件が完了したら、PowerAutomate-> Data-> 接続に移動します。 '新規接続' をクリックし、下のスクリーンショットに示すように、右側の検索バーで MongoDB を検索します。
MongoDB 接続をクリックすると、API キーとベース URL の入力を求める以下のポップアップが表示されます。
1: "APIキー" フィールドに、 手順 3 で設定した Data API キーを入力します
2: "BaseUrl" には、MongoDB Atlas ポータル > Data API で見つけた URL エンドポイント を入力します。
MongoDB Atlas に対する CRUD 操作には、Data API のいずれかを使用します。 複雑なクエリの場合は、"集計パイプラインの実行" API を使用して、集計ステージを使用して、あるステージから別のステージへの出力を処理します。 MongoDB の柔軟性とダイナミズムにより、リッチなアプリを作成し、時間のかかるプロセスを自動化できます。 同じコレクションにさらに機能やフィールドを追加して、アプリを強化し続けます。
さらに、Appsource をチェックして、 Power Apps、 Power Automate 、MongoDB Atlas を使用して構築された Banking Customer Onboarding アプリケーションのハンズオン デモを確認してください。 同じものの Github リンクは こちらです。
既知の問題と制限事項
MongoDB はスキーマを適用しないため、現在のコネクタは Power Automate と Logic Apps でのみ使用できます。これは、API 応答の動的スキーマをサポートし、"Parse JSON" コンストラクトを使用して解析できます。 MongoDB インタラクションごとに Power Apps フローを呼び出すことで、 Power Automate で使用できます。 また、Microsoft Github リポジトリ の認定済み MongoDB コネクタをカスタム コネクタとして引き続き使用して、MongoDB コレクション スキーマに従って Power Apps で直接使用してレスポンス スキーマをカスタマイズすることもできます。
MongoDB Data API に適用される制限は、MongoDB コネクタにも適用されます。 この リンク を参照して、Data API のユーザー コンテキストでサポートされていない集計ステージについて詳しく確認してください。
リクエストに関する既知の制限については、この リンク に従ってください
一般的なエラーと解決策
一般的なエラー コードについてはこの リンク を、リクエスト トラフィックの制限による既知のエラーについては リンク を参照してください
接続を作成する
このコネクタは、次の認証タイプをサポートしています:
| 既定 | 接続を作成するためのパラメーター。 | すべての地域 | 共有不可 |
既定
適用できるもの: すべての領域
接続を作成するためのパラメーター。
これは共有可能な接続ではありません。 パワー アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。
| 件名 | タイプ | 説明設定 | Required |
|---|---|---|---|
| API Key | securestring | この API の API キー | True |
| BaseUrl | string | ベース URL (例: https://data.mongodb-api.com/app//エンドポイント/data/v1) | True |
調整制限
| 名前 | 呼び出し | 更新期間 |
|---|---|---|
| 接続ごとの API 呼び出し | 100 | 60 秒 |
アクション
| ドキュメントの挿入 |
insertOne エンドポイント を使用して、ドキュメントをコレクションに追加できます。 要求本文で document プロパティを使用して、作成するドキュメントを指定します。 |
| ドキュメントを削除する |
単一ドキュメントを削除するには、ひとつのエンドポイントを削除します。 検索条件を指定するには、要求本文で filter プロパティを使用します。 条件に一致するドキュメントが複数ある場合は、最初に一致したドキュメントのみが削除されます。 |
| ドキュメントを更新 |
updateOne エンドポイントを使って単一レコードを更新できます。 検索条件を指定するには、要求本文で filter プロパティを使用します。 条件に一致するドキュメントが複数ある場合は、最初に一致したドキュメントのみが返されます。 次に、更新フィールドを使用して、何を更新するかを指定します。 ドキュメントを更新するには、更新演算子のいずれかを使用する必要があります。 |
| ドキュメントを見つける |
findOne エンドポイント を使用すると、コレクションから 1 つのドキュメントを取得できます。 検索条件を指定するには、要求本文で filter プロパティを使用します。 条件に一致するドキュメントが複数ある場合は、最初に一致したドキュメントのみが返されます。 |
| 多数のドキュメントの削除 |
deleteMany を使用して、複数のドキュメントを一度に削除できます。 filter プロパティを使用して、削除するドキュメントを指定します。 この API をフィルタなしで使用すると、コレクション内のすべてのドキュメントが削除されることに注意してください。 deletemany は注意して使用してください。 |
| 複数のドキュメントを挿入 |
insertMany エンドポイントを使用すると、一度に複数のドキュメントを追加することもできます。 その場合、要求の本文で documents プロパティを使用して、コレクションに挿入するドキュメントの配列を指定する必要があります。 |
| 複数のドキュメントを更新 |
updateMany を使用すると、リクエストの本文で指定された特定のフィルターに一致するすべてのドキュメントを更新できます。 ドキュメントを更新するには、更新フィールドで演算子の更新の一つを使用します。 |
| 複数のドキュメントを検索 |
find エンドポイント を使用すると、一度に複数のドキュメントを取得できます。 フィルターする条件を指定するには、要求本文で filter プロパティを使用します。 空のオブジェクトを渡すと、コレクション内のすべてのドキュメントが返されます。 |
| 集計パイプライン実行する |
Data API を使用して集計パイプラインを実行することもできます。 これを行うには、集約エンドポイント を使用して、リクエスト本文のパイプライン フィールドにパイプラインを指定します。 |
ドキュメントの挿入
insertOne エンドポイント を使用して、ドキュメントをコレクションに追加できます。 要求本文で document プロパティを使用して、作成するドキュメントを指定します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
MongoDB クラスター名
|
dataSource | True | string |
クラスターの名前。 |
|
MongoDB データベース名
|
database | True | string |
データベースの名前です。 |
|
MongoDB コレクション名
|
collection | True | string |
コレクションの名前。 |
|
document
|
document | True | object |
コレクションに挿入する EJSON ドキュメント。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
insertedId
|
insertedId | string |
insertedId |
ドキュメントを削除する
単一ドキュメントを削除するには、ひとつのエンドポイントを削除します。 検索条件を指定するには、要求本文で filter プロパティを使用します。 条件に一致するドキュメントが複数ある場合は、最初に一致したドキュメントのみが削除されます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
MongoDB クラスター名
|
dataSource | True | string |
クラスターの名前。 |
|
MongoDB データベース名
|
database | True | string |
データベースの名前です。 |
|
MongoDB コレクション名
|
collection | True | string |
コレクションの名前。 |
|
filter
|
filter | True | object |
MongoDB クエリ フィルター。 deleteOne アクションは、このフィルターに一致するコレクション内の最初のドキュメントを削除します。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
deletedCount
|
deletedCount | integer |
deletedcount |
ドキュメントを更新
updateOne エンドポイントを使って単一レコードを更新できます。 検索条件を指定するには、要求本文で filter プロパティを使用します。 条件に一致するドキュメントが複数ある場合は、最初に一致したドキュメントのみが返されます。 次に、更新フィールドを使用して、何を更新するかを指定します。 ドキュメントを更新するには、更新演算子のいずれかを使用する必要があります。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
MongoDB クラスター名
|
dataSource | True | string |
クラスターの名前。 |
|
MongoDB データベース名
|
database | True | string |
データベースの名前です。 |
|
MongoDB コレクション名
|
collection | True | string |
コレクションの名前。 |
|
filter
|
filter | True | object |
MongoDB クエリ フィルター。UpdateOne アクションは、このフィルターに一致するコレクション内の最初のドキュメントを変更します。 |
|
update
|
update | True | object |
一致したドキュメントを変更する方法を指定する MongoDB 更新式。 |
|
upsert
|
upsert | boolean |
Upsert フラグは、指定されたフィルターに一致するドキュメントがない場合にのみ適用されます。 true の場合、updateOne アクションは、指定された更新が適用されたフィルターに一致する新しいドキュメントを挿入します。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
matchedCount
|
matchedCount | integer |
matchedcount |
|
modifiedCount
|
modifiedCount | integer |
modifiedcount |
ドキュメントを見つける
findOne エンドポイント を使用すると、コレクションから 1 つのドキュメントを取得できます。 検索条件を指定するには、要求本文で filter プロパティを使用します。 条件に一致するドキュメントが複数ある場合は、最初に一致したドキュメントのみが返されます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
MongoDB クラスター名
|
dataSource | True | string |
クラスターの名前。 |
|
MongoDB データベース名
|
database | True | string |
データベースの名前です。 |
|
MongoDB コレクション名
|
collection | True | string |
コレクションの名前。 |
|
filter
|
filter | object |
MongoDB クエリ フィルター。 findOne アクションは、このフィルターに一致するコレクション内の最初のドキュメントを返します。 |
|
|
プロジェクション
|
projection | object |
MongoDB クエリ プロジェクション。 プロジェクションに応じて、返されるドキュメントには特定のフィールドが省略されるか、指定されたフィールドまたは値のみが含まれます |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
document
|
document | object |
document |
多数のドキュメントの削除
deleteMany を使用して、複数のドキュメントを一度に削除できます。 filter プロパティを使用して、削除するドキュメントを指定します。 この API をフィルタなしで使用すると、コレクション内のすべてのドキュメントが削除されることに注意してください。 deletemany は注意して使用してください。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
MongoDB クラスター名
|
dataSource | True | string |
クラスターの名前。 |
|
MongoDB データベース名
|
database | True | string |
データベースの名前です。 |
|
MongoDB コレクション名
|
collection | True | string |
コレクションの名前。 |
|
filter
|
filter | True | object |
MongoDB クエリ フィルター。 deleteMany アクションは、このフィルターに一致するコレクション内のすべてのドキュメントを削除します。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
deletedCount
|
deletedCount | integer |
deletedCount |
複数のドキュメントを挿入
insertMany エンドポイントを使用すると、一度に複数のドキュメントを追加することもできます。 その場合、要求の本文で documents プロパティを使用して、コレクションに挿入するドキュメントの配列を指定する必要があります。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
MongoDB クラスター名
|
dataSource | True | string |
クラスターの名前。 |
|
MongoDB データベース名
|
database | True | string |
データベースの名前です。 |
|
MongoDB コレクション名
|
collection | True | string |
コレクションの名前。 |
|
documents
|
documents | object |
アイテム |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
insertedIds
|
insertedIds | array of string |
insertedIds |
複数のドキュメントを更新
updateMany を使用すると、リクエストの本文で指定された特定のフィルターに一致するすべてのドキュメントを更新できます。 ドキュメントを更新するには、更新フィールドで演算子の更新の一つを使用します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
MongoDB クラスター名
|
dataSource | True | string |
クラスターの名前。 |
|
MongoDB データベース名
|
database | True | string |
データベースの名前です。 |
|
MongoDB コレクション名
|
collection | True | string |
コレクションの名前。 |
|
filter
|
filter | True | object |
MongoDB クエリ フィルター。 updateMany アクションは、このフィルターに一致するコレクション内のすべてのドキュメントを修正します。 |
|
update
|
update | True | object |
一致したドキュメントを変更する方法を指定する MongoDB 更新式。 |
|
upsert
|
upsert | boolean |
Upsert フラグは、指定されたフィルターに一致するドキュメントがない場合にのみ適用されます。 true の場合、updateMany アクションは、指定された更新が適用されたフィルターに一致する新しいドキュメントを挿入します。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
matchedCount
|
matchedCount | integer |
matchedcount |
|
modifiedCount
|
modifiedCount | integer |
modifiedcount |
複数のドキュメントを検索
find エンドポイント を使用すると、一度に複数のドキュメントを取得できます。 フィルターする条件を指定するには、要求本文で filter プロパティを使用します。 空のオブジェクトを渡すと、コレクション内のすべてのドキュメントが返されます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
MongoDB クラスター名
|
dataSource | True | string |
クラスターの名前。 |
|
MongoDB データベース名
|
database | True | string |
データベースの名前です。 |
|
MongoDB コレクション名
|
collection | True | string |
コレクションの名前。 |
|
filter
|
filter | object |
MongoDB クエリ フィルタ。検索アクションは、このフィルタに一致するコレクション内のドキュメントを返します。フィルタを指定しない場合、アクションはコレクション内のすべてのドキュメントに一致します。 |
|
|
プロジェクション
|
projection | object |
MongoDB クエリ プロジェクション。プロジェクションに応じて、返されるドキュメントには特定のフィールドが省略されるか、指定されたフィールドまたは値のみが含まれます。 |
|
|
並べ替え
|
sort | object |
MongoDB 並べ替え式。 一致したドキュメントは、式で指定されたフィールドの昇順または降順で返されます。 |
|
|
制限
|
limit | integer |
返される結果セットに含める、一致したドキュメントの最大数。 各リクエストは、最大 50,000 のドキュメントを返す場合があります。 |
|
|
skip
|
skip | integer |
一致したドキュメントを結果セットに追加する前にスキップする一致したドキュメントの数。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
documents
|
documents | array of object |
documents |
|
アイテム
|
documents | object |
集計パイプライン実行する
Data API を使用して集計パイプラインを実行することもできます。 これを行うには、集約エンドポイント を使用して、リクエスト本文のパイプライン フィールドにパイプラインを指定します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
MongoDB クラスター名
|
dataSource | True | string |
クラスターの名前。 |
|
MongoDB データベース名
|
database | True | string |
データベースの名前です。 |
|
MongoDB コレクション名
|
collection | True | string |
コレクションの名前。 |
|
pipeline
|
pipeline | object |
アイテム |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
documents
|
documents | array of object |
documents |
|
アイテム
|
documents | object |