このページには、フェデレーティッドデータベースインスタンスのストレージ構成の設定、更新、および検索するに使用できる一般的なコマンドが含まれています。AWS S3 暗号化などの特定のデータ保存構成については、特定のデータ保存ドキュメントを参照してください。
フェデレーティッドデータベースインスタンスに対するデータ保存の定義
フェデレーティッドデータベースインスタンスのストレージを構成するには、ストレージを定義し、クエリ可能なコレクションにマップするストレージ構成JSONファイルを作成する必要があります。MongoDB は、次のデータ ストア向けにフェデレーティッドデータベースインスタンスのサポートを提供します。
重要
ストレージ構成内の情報はMongoDBの内部で表示され、Atlas Data Federation のパフォーマンスをモニターして改善するための運用データとして保存されます。構成では PII を使用しないことをお勧めします。
データアクセス タイプ
フェデレーティッドデータベースインスタンスを作成すると、Atlas にAWSアカウントのAWSバケットへの次のいずれかのタイプのデータアクセスが許可されます。
読み取り専用アクセス: データを変更したり、新しいデータを追加したりすることはできません。
読み取りおよび書き込み (write) アクセス: 既存のファイルを更新したり、ファイルを削除したり、ストレージに新しいデータを追加したりできます。
Atlas クラスターにアクセスするために、Atlas は既存の ロールベースのアクセス制御 を使用します。自己管理型配置でのユーザーとロールの管理の手順に従って、ユーザーのアクセス権を表示および編集できます。
権限アクション
権限アクションは、フェデレーティッドデータベースインスタンスに対して実行できる操作です。次のいずれかの方法で権限アクションを付与できます。
インターフェイスからカスタムロールを 作成または変更するAtlas user 場合
Atlas API からカスタムロールを
actions.action作成 または 更新 する際の リクエスト本文パラメータ内
次の表は、使用可能なフェデレーティッドデータベースインスタンスの権限アクションを示しています。
コマンド | 説明 |
|---|---|
コレクションまたはビュー用に保存されたスキーマを検索するか、詳しくは | |
コレクションまたはビューのスキーマを設定または削除するかどうかの詳細については、 | |
サポートされているフェデレーティッドデータベースインスタンス保存のいずれか 1 つまたは複数のサポートされているフェデレーティッドデータベースインスタンス保存からS3バケットに$outを使用してデータを書き込みます。 | |
サポートされているフェデレーティッドデータベースインスタンスのいずれか一つまたは複数のサポートされているフェデレーティッドデータベースインスタンスの保存から、Google Cloud ストレージバケットに書き込み (write) $out を使用してデータを書き込みます。 | |
storageGetConfig コマンドを使用して、フェデレーティッドデータベースインスタンスの ストレージ構成 を検索します。 | |
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、変更を適用する前にフェデレーティッドデータベースインスタンスの構成を検証することをお勧めします。
フェデレーティッドデータベースインスタンスの構成を更新するには、次の手順に従います。データストア、データソース、データベース、コレクション、ビュー。
フェデレーティッドデータベースインスタンスのストレージ構成を変更します。
データソースの管理
データソースを追加する
stores JSON構成設定に対応します。
[Add Data Store Sources] をクリックします。
構成するデータソースプロバイダーを選択します。- AWS S3 の場合は、フェデレーティッドデータベースインスタンス保存の配置のステップ 5 に進みます。- Google Cloud の場合は、フェデレーティッドデータベースインスタンス保存を配置するのステップ 7 に進みます。- Azureの場合、フェデレーティッドデータベースインスタンスの保存を配置するステップ 7 に進みます。- Atlas クラスターの場合、フェデレーティッドデータベースインスタンス保存の配置ステップ 7 に進みます。- HTTP保存の場合は、フェデレーティッドデータベースインスタンス保存の配置するステップ 7 に進みます。- Atlas オンラインアーカイブで、フェデレーティッドデータベースインスタンス データストアの配置 のステップ 7 に進みます。
データソース名を編集
stores.[n].name JSON構成設定に対応します。
左側のリストからデータ保存ソースを選択します。
ストア名の編集 アイコンをクリックします。
データ保存名フィールドの現在の名前を変更します。
[ Done ] をクリックします。
データソースを削除する
左側のリストから Data Store ソースを選択します
[ Delete このストアを削除 ] アイコンをクリックします
削除するボタンをクリックします。
データベースの管理
新しいデータベースの作成
databases JSON構成設定に対応します。
右上隅の データベースの追加 ボタンをクリックします
データベース名フィールドに入力します
コレクション名フィールドに入力します
作成ボタンをクリックします
データベース名の編集
databases.[n].name JSON構成設定に対応します。
リストからデータベースを選択します。
[ データベース名の編集 ] アイコンをクリックします。
データベース名を更新します。
[ Done ] ボタンをクリックします。
データベースの削除
リストからデータベースを選択します。
[ このデータベースを削除 ] アイコンをクリックします。
削除するボタンをクリックします。
コレクションの管理
データベースでの新しいコレクションの作成
databases.[n].collections JSON構成設定に対応します。
コレクションを作成するデータベースを選択します
[Add Collection(コレクションを追加)] アイコンをクリックします
コレクション名フィールドに入力します
作成ボタンをクリックします
コレクション名の編集
databases.[n].collections.[n].name JSON構成設定に対応します。
リストからコレクションを選択します
[ コレクション名の編集 ] アイコンをクリックします
新しい名前のコレクション名フィールドの現在の名前を変更します
作成ボタンをクリックします
コレクションの削除
リストからコレクションを選択します
[ Delete このコレクションを削除 ] アイコンをクリックします
削除するボタンをクリックします。
ビューの管理
コレクションでの新しいビューの作成
databases.[n].views JSON構成設定に対応します。
ビューを作成するコレクションを選択します
[Add View(ビューを追加)] アイコンをクリックします
[ ビュー名 ]フィールドに入力します
マニュアルの パイプライン _core/aggregation- pipeline/>`フィールドに入力します
作成ボタンをクリックします
ビュー名またはパイプラインの編集
それぞれdatabases.[n].views.[n].nameとdatabases.[n].views.[n].pipelineのJSON構成設定に対応します。
コレクションからビューを選択します
[ ビュー名の編集 ] アイコンをクリックします
新しい名前の 表示名フィールドの現在の名前を変更します
新しいパイプラインのパイプラインフィールドで現在のパイプラインを変更する
保存ボタンをクリックします
ビューを削除する
リストからビューを選択します
このビューを削除する アイコンをクリックします
削除するボタンをクリックします。
JSON構成ファイルオブジェクトを編集して、stores、databases、または views を追加、作成、または除くします
特定のデータストアプロバイダーの構成設定の詳細については、「構成ファイル」ページを参照してください。
MongoDB Shell(mongosh)を使用してストレージ構成を設定および管理する方法については、 フェデレーティッドデータベースインスタンスの管理 ページを参照してください。
ワイルドカード コレクションの生成
重要
ワイルドカード コレクション機能は、 AWS S3 および Atlas クラスターのデータソースで のみ 使用できます。
AWS S3 または Atlas クラスター のデータソースを使用する場合は、データにマッピングするコレクション名を動的に設定できます。コレクション名を生成するには、フェデレーティッドデータベースインスタンスストレージ構成のコレクション名設定の値としてワイルドカード シンボル * を指定します。
Tip
storageSetConfigコマンドを使用して、ワイルドカード( * )コレクションを生成する設定を構成できます。