フェデレーティッドデータベースインスタンスの配置
このページでは、フェデレーティッドデータベースインスタンスを配置して HTTPデータ ストアのデータにアクセスする方法について説明します。
必要なアクセス権
フェデレーティッドデータベースインスタンスを配置するには、プロジェクトに対する Project Owner
アクセス権が必要です。 Organization Owner
アクセスを持つユーザーは、フェデレーティッドデータベースインスタンスを配置する前に、自分自身をProject Owner
としてプロジェクトに追加する必要があります。
前提条件
始める前に、次のことを行う必要があります。
MongoDB Atlasアカウントがまだない場合は、作成し 。
サポートされているデータ形式のいずれかを使用して、データ ストアをフォーマットします。
注意
ファイル形式が
CSV
またはTSV
の場合、データにヘッダー行を含める必要があります。詳細については、「CSV および TSV」を参照してください。パブリック インターネット経由でデータストアにアクセスできるようにします。
重要
HTTPS 経由 で HTTP データストアにアクセスできない場合は、JSON Editor を使用してデータストアを構成する必要があります。JSON構成で、
stores.[n].allowInsecure
設定をtrue
に設定する必要があります。Atlas Data Federation は、認証を必要とするHTTPデータ ストアURLをサポートしていません。
手順
Atlas CLI を使用して新しい Data Federation データベースを作成するには、次のコマンドを実行します。
atlas dataFederation create <name> [options]
コマンド構文とパラメーターの詳細については、 Atlas CLIドキュメントのAtlas dataFederation create を参照してください。
データストアを指定します。
Data Sourcesセクションからフェデレーティッドデータベースインスタンスのデータセットを選択します。
データストアを選択するには、 Add Data Sourcesをクリックします。
データストアを指定します。
一般にアクセス可能なHTTPおよびHTTPS URL内のデータ用にフェデレーティッドデータベースインスタンスを構成するには、 HTTP(S)を選択します。
stores.[n].provider
JSON構成設定に対応します。HTTP(S) Store NameフィールドにHTTPデータストアの名前を入力します。
注意
データストアの名前は、フェデレーティッドデータベースインスタンス内で一意である必要があります。
stores.[n].name
JSON構成設定に対応します。データが保存されているファイルの一般にアクセス可能なURLを入力します。
Atlas Data Federation は、 JSON 、 BSON 、 CSV 、 TSV 、Avro(gzip または非圧縮)、Parquet、ORC ファイルの種類をサポートしています。
Tip
サンプルHTTPデータ ストアを追加するには、 Use Sample URLをクリックします。
追加する追加のHTTPデータストアごとに、 Add Another URLをクリックし、 HTTPデータストアの URL を入力します。
stores.[n].urls
JSON構成設定に対応します。仮想データベースとコレクションを構成するには、 Nextをクリックします。
仮想データベース、コレクション、ビューを作成し、データベース、コレクション、ビューをデータ ストアにマッピングします。
(任意)クリックのために
データベース名を編集するデータベース。 デフォルトは
VirtualDatabase[n]
です。databases.[n].name
JSON構成設定に対応します。コレクション名を編集するためのコレクション。 デフォルトは
VirtualCollection[n]
です。databases.[n].collections.[n].name
JSON構成設定に対応します。を使用してビュー名を編集します。
次のコマンドをクリックできます。
Add Database : データベースとコレクションを追加します。
データベースにコレクションを追加するために関連付けられています。
コレクションにビューを追加するコレクションに関連付けられている ビューを作成するには、以下を指定する必要があります。
ビューの名前。
ビューに適用するパイプライン。
ビュー定義パイプラインには、
$out
または$merge
ステージを含めることはできません。 ビュー定義に、$lookup
や$facet
などのネストされたパイプライン ステージが含まれている場合、この制限はそれらのネストされたパイプラインにも適用されます。
ビューの詳細については、以下を参照してください。
関連付けられているデータベース、コレクション、またはビューを削除します。
Data SourcesセクションのドロップダウンからHTTPを選択します。
データ ストアをドラッグして削除し、コレクションとマッピングします。
databases.[n].collections.[n].dataSources
JSON構成設定に対応します。
HTTPデータ ストアの構成は次のようになります。
1 { 2 "stores" : [ 3 { 4 "name" : "<string>", 5 "provider": "<string>", 6 "defaultFormat" : "<string>", 7 "allowInsecure": <boolean>, 8 "urls": ["<string>"] 9 } 10 ], 11 "databases" : [ 12 { 13 "name" : "<string>", 14 "collections" : [ 15 { 16 "name" : "<string>", 17 "dataSources" : [ 18 { 19 "storeName" : "<string>", 20 "allowInsecure" : <boolean>, 21 "urls" : ["<string>"], 22 "defaultFormat" : "<string>", 23 "provenanceFieldName": "<string>" 24 } 25 ] 26 } 27 ], 28 "views" : [ 29 { 30 "name" : "<string>", 31 "source" : "<string>", 32 "pipeline" : "<string>" 33 } 34 ] 35 } 36 ] 37 }
構成設定の詳細については、 HTTP URL を参照してください。
HTTPデータ ストアを定義します。
stores
の UI に表示されるJSON構成設定を編集します。stores
の構成設定は次のようになります。"stores" : [ { "name" : "<string>", "provider" : "<string>", "allowInsecure": <boolean>, "urls" : ["<string>"], "defaultFormat" : "<string>" } ] これらの構成設定の詳細については、
stores
を参照してください。フェデレーティッドデータベースインスタンスの仮想データベース、コレクション、ビューを定義します。
databases
の UI に表示されるJSON構成設定を編集します。databases
の構成設定は次のようになります。"databases" : [ { "name" : "<string>", "collections" : [ { "name" : "<string>", "dataSources" : [ { "storeName" : "<string>", "allowInsecure" : <boolean>, "urls" : ["<string>"], "defaultFormat" : "<string>", "provenanceFieldName": "<string>" } ] } ] } ] これらの構成設定の詳細については、
databases
を参照してください。