フェデレーティッドデータベースインスタンスの配置
このページでは、フェデレーティッドデータベースインスタンスを配置してGoogleGoogle Cloud Platform Cloud Platform Storage バケット内のデータにアクセスする方法について説明します。
必要なアクセス権
フェデレーティッドデータベースインスタンスを配置するには、プロジェクトに対する Project Owner
アクセス権が必要です。 Organization Owner
アクセスを持つユーザーは、フェデレーティッドデータベースインスタンスを配置する前に、自分自身をProject Owner
としてプロジェクトに追加する必要があります。
前提条件
始める前に、次のことを行う必要があります。
MongoDB Atlasアカウントがまだない場合は、作成し 。
Google Cloud Platformアカウントにアクセスするには、gcloud CLICLIGoogle Cloud Platform を設定します。または、IAM ロールを作成するには、権限を持つGoogleGoogle Cloud Platform Cloud Platformコンソールへのアクセス権が必要です。
任意。 Google Cloud PlatformGoogle Cloud Platformサービス アカウントを設定します。
手順
Atlas CLI を使用して新しい Data Federation データベースを作成するには、次のコマンドを実行します。
atlas dataFederation create <name> [options]
コマンド構文とパラメーターの詳細については、 Atlas CLIドキュメントのAtlas dataFederation create を参照してください。
Atlas Data Federation がフェデレーティッドデータベースインスタンスに対してクエリを処理するクラウドプロバイダーを選択します。
Amazon Web ServicesAzure[0}Google Cloud Platform Amazon Web Services ] 、 Azure 、またはGoogle Cloud Platformを選択できます。フェデレーティッドデータベースインスタンスが作成された後は、Atlas Data Federation がクエリを処理するクラウドプロバイダーを変更することはできません。
フェデレーティッドデータベースインスタンスは、フェデレーティッドデータベースインスタンスがマップされるデータストアと同じクラウドプロバイダーに構成する必要があります。
GoogleGoogle Cloud Platform Cloud Platform Storageバケットを指定し、データ ストアにマッピングするフェデレーティッドデータベースと仮想コレクションを構成します。
Data Sourcesセクションからフェデレーティッドデータベースインスタンスのデータセットを選択します。
データストアを選択するには、 Add Data Sourcesをクリックします。
データストアを指定します。
Google Cloud Platform Storage バケット内のデータ用にフェデレーティッドデータベースインスタンスを構成するには、 を選択します。Google Cloud StorageGoogle Cloud Platform
stores.[n].provider
JSON構成設定に対応します。Atlas Google Cloud PlatformのGoogle Cloud Platformサービス アカウントを選択します。Atlas
ロール選択ドロップダウン リストから、Atlas に認可されている既存のGoogle Cloud Platformサービス アカウントを選択するか、[]Google Cloud PlatformAtlasCreate a Google Service Account を選択します。
Atlas が認可する既存のアカウントを選択した場合は、Atlas をクリックし、次の手順に進み、Next Google Cloud PlatformGoogle Cloud Platform Storage バケットを一覧表示します。
新しいサービス アカウントを作成する場合は、Create a Google Service Account を選択し、Next をクリックします。
Tip
以下も参照してください。
Google Cloud PlatformGoogle Cloud Platformサービス アカウント アクセスの設定と管理 ``security/set-up-unified-aws-access/>``
Configure Google Cloud Storageモーダルで、表示される手順に従ってGoogle Cloud Platform CLI を設定し、Google Cloud PlatformCLI Nextをクリックします。
Google CloudGoogle Cloud Platform Platformストレージ の構成。
Google Cloud PlatformGoogle Cloud Platform Storageバケットの名前を入力します。
stores.[n].bucket
JSON構成設定に対応します。バケットがRead-onlyであるか、両方のRead and writeであるかを指定します。
AtlasRead-onlyAtlas はGoogle Cloud Platform Read and writeバケットのみをクエリできます。 Google Cloud Platform Storageバケットにクエリを実行してクエリ結果を保存する場合は、 を選択します。
GoogleGoogle Cloud Platform Cloud Platform Storageバケットのリージョンを選択します。
stores.[n].region
JSON構成設定に対応します。注意
Atlas Data FederationAtlasGCP Data Federation が指定されたGCPストレージバケットのリージョンを取得できない場合は、フェデレーティッドデータベースインスタンスを作成できません。
GoogleGoogle Cloud Platform Cloud Platformプロジェクトへのアクセスを許可します。
Google Cloud PlatformGoogleGoogle Cloud Platform Cloud Platform StorageバケットをホストするプロジェクトのGoogle Cloud Platformコンソールで、 に移動し、次にIAM and Admin IAMに移動します。
[Grant Access] をクリックします。表示されるモーダルの [ フィールド] に、フェデレーティッドデータベースインスタンスに関連付けられているGoogleNew principals Google Cloud PlatformCloud Platformサービス アカウント を入力します。
バケットへの読み取り専用アクセスを許可するには、
storage.viewer
ロールを適用します。バケットへの読み取りおよび書き込みアクセス権を付与するには、storage.editor
ロールを追加で適用します。
任意 。Data FederationGoogle Cloud PlatformGoogle Cloud Platform Storageバケット内のファイルを検索するときに Data Federation が使用するプレフィックスを指定します。Data Federation省略した場合、DataGoogle Cloud Platform Federation はGoogle Cloud Platform Storageバケットのルートからすべてのファイルを再帰的に検索します。
stores.[n].prefix
JSON構成設定に対応します。クリック Validate and finish.
Google Cloud Platform Storageバケット内のファイルのパス構造を定義し、 をクリックします。Google Cloud PlatformNext
以下に例を挙げます。
https://storage.googleapis.com/<path>/<to>/<files>/<filename>.<file-extension> GoogleGoogle Cloud Platform Cloud Platform Storageバケット上のデータへの追加パスを追加するには、 をクリックしてAdd Data Source パスを入力します。パスの詳細については、「 S3 データのパスの定義 」を参照してください。
databases.[n].collections.[n].dataSources.[n].path
JSON構成設定に対応します。仮想データベース、コレクション、ビューを作成し、データベース、コレクション、ビューをデータ ストアにマッピングします。
(任意)クリックのために
データベース名を編集するデータベース。 デフォルトは
VirtualDatabase[n]
です。databases.[n].name
JSON構成設定に対応します。コレクション名を編集するためのコレクション。 デフォルトは
VirtualCollection[n]
です。databases.[n].collections.[n].name
JSON構成設定に対応します。を使用してビュー名を編集します。
次のコマンドをクリックできます。
Add Database : データベースとコレクションを追加します。
データベースにコレクションを追加するために関連付けられています。
コレクションにビューを追加するコレクションに関連付けられている ビューを作成するには、以下を指定する必要があります。
ビューの名前。
ビューに適用するパイプライン。
ビュー定義パイプラインには、
$out
または$merge
ステージを含めることはできません。 ビュー定義に、$lookup
や$facet
などのネストされたパイプライン ステージが含まれている場合、この制限はそれらのネストされたパイプラインにも適用されます。
ビューの詳細については、以下を参照してください。
関連付けられているデータベース、コレクション、またはビューを削除します。
Data SourcesセクションのドロップダウンからGoogle Cloud Storageを選択します。
データ ストアをドラッグして削除し、コレクションとマッピングします。
databases.[n].collections.[n].dataSources
JSON構成設定に対応します。
Google Cloud PlatformGoogle Cloud Platform Storage データ ストアの構成は次のようになります。
{ "stores" : [ { "name" : "<string>", "provider" : "<string>", "region" : "<string>", "bucket" : "<string>", "prefix": "<string>", "delimiter": "<string>" } ], "databases" : [ { "name" : "<string>", "collections" : [ { "name" : "<string>", "dataSources" : [ { "storeName" : "<string>", "path" : "<string>", "defaultFormat" : "<string>", "provenanceFieldName": "<string>", "omitAttributes": <boolean> } ] } ], "maxWildcardCollections" : <integer>, "views" : [ { "name" : "<string>", "source" : "<string>", "pipeline" : "<string>" } ] } ] }
構成設定の詳細については、「フェデレーティッドデータベースインスタンス用のデータストアの定義 」を参照してください。
Amazon Web Services S3 データ ストアを定義します。
stores
の UI に表示されるJSON構成設定を編集します。stores
の構成設定は次のようになります。"stores" : [ { "name" : "<string>", "provider" : "<string>", "region" : "<string>", "bucket" : "<string>", "additionalStorageClasses" : ["<string>"], "prefix" : "<string>", "delimiter" : "<string>", "includeTags": <boolean>, "public": <boolean> } ] これらの構成設定の詳細については、
stores
を参照してください。フェデレーティッドデータベースインスタンスの仮想データベース、コレクション、ビューを定義します。
databases
の UI に表示されるJSON構成設定を編集します。databases
の構成設定は次のようになります。"databases" : [ { "name" : "<string>", "collections" : [ { "name" : "<string>", "dataSources" : [ { "storeName" : "<string>", "defaultFormat" : "<string>", "path" : "<string>", "provenanceFieldName": "<string>", "omitAttributes": <boolean> } ] } ], "maxWildcardCollections" : <integer>, "views" : [ { "name" : "<string>", "source" : "<string>", "pipeline" : "<string>" } ] } ] これらの構成設定の詳細については、
databases
を参照してください。
任意: 上記の Visual エディターまたはJSONエディタータブで手順を繰り返し、追加のAzure Azureストレージ データ ストアを定義します。
フェデレーティッドクエリの他のデータ ストアを追加するには、次を参照してください。
注意
クラウドプロバイダー間でフェデレーティッドクエリを実行するために、Azure Blog Storage データストアを接続することはできません。