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

フェデレーティッドデータベースインスタンスに対する保存の構成

このページには、フェデレーティッドデータベースインスタンスのストレージ構成の設定、更新、および検索するに使用できる一般的なコマンドが含まれています。AWS S3 暗号化などの特定のデータ保存構成については、特定のデータ保存ドキュメントを参照してください。

フェデレーティッドデータベースインスタンスのストレージを構成するには、ストレージを定義し、クエリ可能なコレクションにマップするストレージ構成JSONファイルを作成する必要があります。MongoDB は、次のデータ ストア向けにフェデレーティッドデータベースインスタンスのサポートを提供します。

重要

ストレージ構成内の情報は MongoDB の内部で表示され、Atlas Data Federation のパフォーマンスを監視して改善するための運用データとして保存されます。 構成ではPIIを使用しないことをお勧めします。

フェデレーティッドデータベースインスタンスを作成すると、Atlas にAWSアカウントのAWSバケットへの次のいずれかのタイプのデータアクセスが許可されます。

  • 読み取り専用アクセス: データを変更したり、新しいデータを追加したりすることはできません。

  • 読み取りおよび書き込み (write) アクセス: 既存のファイルを更新したり、ファイルを削除したり、ストレージに新しいデータを追加したりできます。

Atlas クラスターにアクセスするために、Atlas は既存の ロールベースのアクセス制御 を使用します。自己管理型配置でのユーザーとロールの管理 の手順に従って、ユーザーのアクセス権を表示および編集できます。

権限アクションは、フェデレーティッドデータベースインスタンスに対して実行できる操作です。次のいずれかの方法で権限アクションを付与できます。

  • インターフェイスからカスタムロールを 作成または変更するAtlas user 場合

  • Atlas APIからカスタムロールを作成または更新する際の actions.actionリクエスト本文パラメータ内

次の表は、使用可能なフェデレーティッドデータベースインスタンスの権限アクションを示しています。

コマンド
説明
sqlGetSchema

コレクションまたはビュー用に保存されたスキーマを取得します。詳細については、「 sqlGetSchema 」を参照してください。

sqlSetSchema

コレクションまたはビューのスキーマを設定または削除します。詳細については、「 sqlGetSchema 」を参照してください。

viewAllHistory
outToAzure

サポートされているフェデレーティッドデータベースインスタンスストアの 1 つまたは複数のフェデフェデレーティッドデータベースインスタンスストアからのデータを $out を使用してAzure Blob ストレージコンテナに書込みます。

outToS3

サポートされているフェデレーティッドデータベースインスタンスストアのいずれか 1 つまたは複数のサポートされているフェデレーティッドデータベースインスタンスストアからのデータを S3バケットに $out を使用して書込みます。

outToGCP

サポートされているフェデレーティッドデータベースインスタンスストアのいずれか 1 つまたは複数のサポートされているフェデレーティッドデータベースインスタンスストアから、$outを使用してGoogle Cloud Platform Storageバケットにデータを書込みます。

storageGetConfig

storageGetConfig コマンドを使用して、フェデレーティッドデータベースインスタンスの ストレージ構成 を取得します。

storageSetConfig

storageSetConfig コマンドを使用して、フェデレーティッドデータベースインスタンスの ストレージ構成 を設定または更新します。

フェデレーティッドデータベースインスタンスの構成ファイルを検索するには、インスタンスに接続し、次のコマンドを使用します。

use admin
db.runCommand( { "storageGetConfig" : 1 } )

コマンドは、現在のフェデレーティッドデータベースインスタンスの構成を返します。

フェデレーティッドデータベースインスタンスの構成を検証するには、 をインスタンスに接続し、次のコマンドを使用します。

use admin
db.runCommand( { "storageValidateConfig" : <config> } )

<config>をフェデレーティッドデータベースインスタンスの構成に置き換えます。

構成が有効な場合、コマンドは次の答えるを返します。

{ "ok" : 1 }

構成が無効な場合、コマンドは errsフィールドにエラーのリストを返します。

{
"ok" : 1,
"errs" : [
"<error>",
"<error>",
...
]
}

フェデレーティッドデータベースインスタンスの構成を更新するには、インスタンスに接続し、次のコマンドを使用します。

use admin
db.runCommand( { "storageSetConfig" : <config> } )

<config>をフェデレーティッドデータベースインスタンスの構成に置き換えます。

Tip

MongoDB、変更を適用する前にフェデレーティッドデータベースインスタンスの構成を検証することをお勧めします。

フェデレーティッドデータベースインスタンスの構成を更新するには、次の手順に従います。データストア、データソース、データベース、コレクション、ビュー。

1
2
3
4
  • ビジュアル インターフェースについては、Visual をクリックします。

  • JSONファイルを直接編集するには、JSON Editor をクリックします。

5

stores JSON構成設定に対応します。

  1. [Add Data Store Sources] をクリックします。

  2. Select the data source provider you want to configure: - For AWS S3, continue to step 5 of Deploy a Federated Database Instance Data Store. - For Google Cloud, continue to step 7 of Deploy a Federated Database Instance Data Store. - For Azure, continue to step 7 of Deploy a Federated Database Instance Data Store. - For Atlas Cluster, continue to step 7 of Deploy a Federated Database Instance Data Store. - For HTTP data store, continue to step 7 of Deploy a Federated Database Instance Data Store. - For Atlas Online Archive, continue to step 7 of Deploy a Federated Database Instance Data Store.

stores.[n].name JSON構成設定に対応します。

  1. 左側のリストからデータ保存ソースを選択します。

  2. ストア名の編集 アイコンをクリックします。

  3. データ保存名フィールドの現在の名前を変更します。

  4. [ Done ] をクリックします。

  1. 左側のリストから Data Store ソースを選択します

  2. [ Delete このストアを削除 ] アイコンをクリックします

  3. 削除するボタンをクリックします。

データベースの管理

databases JSON構成設定に対応します。

  1. 右上隅の データベースの追加 ボタンをクリックします

  2. データベース名フィールドに入力します

  3. コレクション名フィールドに入力します

  4. 作成ボタンをクリックします

databases.[n].name JSON構成設定に対応します。

  1. リストからデータベースを選択します。

  2. [ データベース名の編集 ] アイコンをクリックします。

  3. データベース名を更新します。

  4. [ Done ] ボタンをクリックします。

  1. リストからデータベースを選択します。

  2. [ このデータベースを削除 ] アイコンをクリックします。

  3. 削除するボタンをクリックします。

コレクションの管理

databases.[n].collections JSON構成設定に対応します。

  1. コレクションを作成するデータベースを選択します

  2. [Add Collection(コレクションを追加)] アイコンをクリックします

  3. コレクション名フィールドに入力します

  4. 作成ボタンをクリックします

databases.[n].collections.[n].name JSON構成設定に対応します。

  1. リストからコレクションを選択します

  2. [ コレクション名の編集 ] アイコンをクリックします

  3. 新しい名前のコレクション名フィールドの現在の名前を変更します

  4. 作成ボタンをクリックします

  1. リストからコレクションを選択します

  2. [ Delete このコレクションを削除 ] アイコンをクリックします

  3. 削除するボタンをクリックします。

ビューの管理

databases.[n].views JSON構成設定に対応します。

  1. ビューを作成するコレクションを選択します

  2. [Add View(ビューを追加)] アイコンをクリックします

  3. [ ビュー名 ]フィールドに入力します

  4. マニュアルの パイプライン _core/aggregation- pipeline/>`フィールドに入力します

  5. 作成ボタンをクリックします

それぞれdatabases.[n].views.[n].namedatabases.[n].views.[n].pipelineJSON構成設定に対応します。

  1. コレクションからビューを選択します

  2. [ ビュー名の編集 ] アイコンをクリックします

  3. 新しい名前の 表示名フィールドの現在の名前を変更します

  4. 新しいパイプラインのパイプラインフィールドで現在のパイプラインを変更する

  5. 保存ボタンをクリックします

  1. リストからビューを選択します

  2. このビューを削除する アイコンをクリックします

  3. 削除するボタンをクリックします。

JSON構成ファイルオブジェクトを編集して、storesdatabases、または views を追加、作成、または削除します。

特定のデータストアプロバイダーの構成設定の詳細については、「構成ファイル」ページを参照してください。

重要

ワイルドカード コレクション機能は、 AWS S3 および Atlas クラスターのデータソースでのみ使用できます。

AWS S3 または Atlas クラスター のデータソースを使用する場合は、データにマッピングするコレクション名を動的に設定できます。コレクション名を生成するには、フェデレーティッドデータベースインスタンスストレージ構成のコレクション名設定の値としてワイルドカード シンボル * を指定します。

Tip

storageSetConfig コマンドを使用して、ワイルドカード(* )コレクションを生成する設定を構成できます。