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

createStore

createStoreコマンドは、フェデレーティッドデータベースインスタンス ストレージ構成にストアを作成します。 データソース用のフェデレーティッドデータベースインスタンス ストアの作成の詳細については、以下のタブをクリックしてください。

このタブには、 AWS S3 バケット内のデータ用にフェデレーティッドデータベースインスタンスストアを作成するための構文とパラメータが含まれています。

重要

Atlas Data Federation は、異なるクラウドプロバイダーにわたるフェデレーティッドクエリをサポートしていません。 単一のクラウドプロバイダー上のストアにマッピングするフェデレーティッドデータベースインスタンスのみを作成できます。

db.runCommand({ createStore: <store-name>, provider: <storage-provider>, region: <region-name>, bucket: <bucket-name>, additionalStorageClasses: [ <storage-classes> ], delimiter: <delimiter>, public: true|false })
Parameter
タイプ
説明
必須

createStore

string

新しいフェデレーティッドデータベースインスタンス ストアの名前。 フェデレーティッドデータベースインスタンスのストア名は一意である必要があります。

はい

provider

string

データが保存されるサービスの名前。 値は次のいずれかになります。

  • s3 AWS S3 バケット用。

  • azure Azure Blog ストレージ コンテナ用。

  • atlas Atlas クラスター用。

  • http は、一般にアクセス可能なURLでホストされているファイルの 。

  • dls:<subtype> オンライン アーカイブ用。 Atlas Data Federation は次のサブタイプをサポートしています。

    • aws - AWSに保存されているデータの場合。値は dls:awsである必要があります。

    • azure - Azureに保存されているデータの場合。値は dls:azureである必要があります。

はい

region

string

bucketがホストされているリージョン。 有効なリージョン名のリストについては、「 Amazon Web Services 」( Amazon Web Services )を参照してください。

はい

bucket

string

データが保存されるバケットの名前。 Data Federation がAWS IAM 認証情報を使用してアクセスできる S バケットの名前と完全に一致する必要があります。3

はい

additionalStorageClasses

文字列の配列

AWS S3 ストレージ クラスの配列。Atlas Data Federation は、これらのストレージ クラスのファイルをクエリ結果に含めます。有効な値は次のとおりです。

標準ストレージクラス内のファイルはデフォルトでサポートされています。

no

delimiter

string

フェデレーティッドデータベースインスタンス ストア内のパス セグメントを区切るために使用される文字。 省略した場合、デフォルトは"/"になります。

no

public

ブール値

バケットがパブリックかどうかを示すフラグ。 有効な値は以下のとおりです。

  • true バケットにアクセスするためにAmazon Web Services IAMロールを使用しない

  • false にアクセスするにはAmazon Web Services IAMロールが必要です

省略した場合、デフォルトは false になります。

no

コマンドは成功した場合、次の出力を印刷します。 コマンドが失敗した場合、推奨される解決策については「 エラーのトラブルシューティング 」を参照してください。

{ "ok": 1, "store": { "name": "<store-name>", "region": "<region-name>", "bucket": "<bucket-name>", "additionalStorageClasses": ["<storage-classes>"] "delimiter": "<delimiter>", "provider": "<storage-provider>" }}

次の例では、createStore myStoreコマンドを使用して、 という新しいフェデレーティッドデータベースインスタンス ストアを作成します。

use sampledb.runCommand({ createStore: "myStore", provider: "s3", region: "us-east-1", bucket: "my-bucket", "additionalStorageClasses" : ["STANDARD_IA","INTELLIGENT_TIERING"] })
{ "ok": 1, "store": { "name": "myStore", "region": "us-east-1", "bucket": "my-bucket", "additionalStorageClasses" : [ "STANDARD_IA", "INTELLIGENT_TIERING" ], "delimiter": "/", "provider": "s3" }}

コマンドが失敗した場合は、次のいずれかのエラーが返されます。

理由: createStoreで指定された名前のフェデレーティッドデータベースインスタンス ストアはすでに存在します。

{ "ok": 0, "errmsg": "store <store-name> already exists", "code": 2, "codeName": "BadValue"}

解決法:フェデレーティッドデータベースインスタンス ストアの一意の名前を指定します。

理由:指定されたproviderは認識されません。

{ "ok": 0, "errmsg": "unrecognized store provider <storage-provider>", "code": 2, "codeName": "BadValue"}

解決策:有効なストレージプロバイダーを指定していることを確認します。