Docs Menu
Docs Home
/
MongoDB Atlas
/ / /

フェデレーティッドデータベースインスタンスの配置

項目一覧

  • 必要なアクセス権
  • 前提条件
  • 手順

このページでは、フェデレーティッドデータベースインスタンスを配置してGoogleGoogle Cloud Platform Cloud Platform Storage バケット内のデータにアクセスする方法について説明します。

フェデレーティッドデータベースインスタンスを配置するには、プロジェクトに対する Project Ownerアクセス権が必要です。 Organization Ownerアクセスを持つユーザーは、フェデレーティッドデータベースインスタンスを配置する前に、自分自身をProject Ownerとしてプロジェクトに追加する必要があります。

始める前に、次のことを行う必要があります。

  • MongoDB Atlasアカウントがまだない場合は、作成し

  • gcloud CLI をインストールします。

  • 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 を参照してください。

Tip

参照: 関連リンク

1
2
3
  1. [ Create New Federated Database ] ドロップダウンをクリックします。

  2. Manual Setup を選択します。

4

Amazon Web ServicesAzure[0}Google Cloud Platform Amazon Web Services ] 、 Azure 、またはGoogle Cloud Platformを選択できます。フェデレーティッドデータベースインスタンスが作成された後は、Atlas Data Federation がクエリを処理するクラウドプロバイダーを変更することはできません。

フェデレーティッドデータベースインスタンスは、フェデレーティッドデータベースインスタンスがマップされるデータストアと同じクラウドプロバイダーに構成する必要があります。

5

デフォルトはFederatedDatabaseInstance[n]です。 フェデレーティッドデータベースインスタンスは、一度作成されると変更できません。

6
  • ガイドを利用する場合は、 Visual Editorをクリックします。

  • 未加工のJSONを編集するには、 JSON Editorをクリックします。

7
  1. Data Sourcesセクションからフェデレーティッドデータベースインスタンスのデータセットを選択します。

    データストアを選択するには、 Add Data Sourcesをクリックします。

  2. データストアを指定します。

    Google Cloud Platform Storage バケット内のデータ用にフェデレーティッドデータベースインスタンスを構成するには、 を選択します。Google Cloud StorageGoogle Cloud Platform

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

  3. 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

    以下も参照してください。

  4. Configure Google Cloud Storageモーダルで、表示される手順に従ってGoogle Cloud Platform CLI を設定し、Google Cloud PlatformCLI Nextをクリックします。

  5. Google CloudGoogle Cloud Platform Platformストレージ の構成。

    1. Google Cloud PlatformGoogle Cloud Platform Storageバケットの名前を入力します。

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

    2. バケットがRead-onlyであるか、両方のRead and writeであるかを指定します。

      AtlasRead-onlyAtlas はGoogle Cloud Platform Read and writeバケットのみをクエリできます。 Google Cloud Platform Storageバケットにクエリを実行してクエリ結果を保存する場合は、 を選択します。

    3. GoogleGoogle Cloud Platform Cloud Platform Storageバケットのリージョンを選択します。

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

      注意

      Atlas Data FederationAtlasGCP Data Federation が指定されたGCPストレージバケットのリージョンを取得できない場合は、フェデレーティッドデータベースインスタンスを作成できません。

    4. GoogleGoogle Cloud Platform Cloud Platformプロジェクトへのアクセスを許可します。

      1. Google Cloud PlatformGoogleGoogle Cloud Platform Cloud Platform StorageバケットをホストするプロジェクトのGoogle Cloud Platformコンソールで、 に移動し、次にIAM and Admin IAMに移動します。

      2. [Grant Access] をクリックします。表示されるモーダルの [ フィールド] に、フェデレーティッドデータベースインスタンスに関連付けられているGoogleNew principals Google Cloud PlatformCloud Platformサービス アカウント を入力します。

      3. バケットへの読み取り専用アクセスを許可するには、storage.viewer ロールを適用します。バケットへの読み取りおよび書き込みアクセス権を付与するには、storage.editor ロールを追加で適用します。

    5. 任意 。Data FederationGoogle Cloud PlatformGoogle Cloud Platform Storageバケット内のファイルを検索するときに Data Federation が使用するプレフィックスを指定します。Data Federation省略した場合、DataGoogle Cloud Platform Federation はGoogle Cloud Platform Storageバケットのルートからすべてのファイルを再帰的に検索します。

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

    6. クリック Validate and finish.

  6. 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].pathJSON構成設定に対応します。

  7. 仮想データベース、コレクション、ビューを作成し、データベース、コレクション、ビューをデータ ストアにマッピングします。

    1. (任意)クリックのために

      • データベース名を編集するデータベース。 デフォルトはVirtualDatabase[n]です。

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

      • コレクション名を編集するためのコレクション。 デフォルトはVirtualCollection[n]です。

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

      • を使用してビュー名を編集します。

      次のコマンドをクリックできます。

      • Add Database : データベースとコレクションを追加します。

      • データベースにコレクションを追加するために関連付けられています。

      • コレクションにビューを追加するコレクションに関連付けられている ビューを作成するには、以下を指定する必要があります。

        • ビューの名前。

        • ビューに適用するパイプライン

          ビュー定義パイプラインには、 $outまたは$mergeステージを含めることはできません。 ビュー定義に、 $lookup$facetなどのネストされたパイプライン ステージが含まれている場合、この制限はそれらのネストされたパイプラインにも適用されます。

        ビューの詳細については、以下を参照してください。

      • 関連付けられているデータベース、コレクション、またはビューを削除します。

    2. Data SourcesセクションのドロップダウンからGoogle Cloud Storageを選択します。

    3. データ ストアをドラッグして削除し、コレクションとマッピングします。

      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>"
}
]
}
]
}

構成設定の詳細については、「フェデレーティッドデータベースインスタンス用のデータストアの定義 」を参照してください。

  1. 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を参照してください。

  2. フェデレーティッドデータベースインスタンスの仮想データベース、コレクション、ビューを定義します。

    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を参照してください。

8

フェデレーティッドクエリの他のデータ ストアを追加するには、次を参照してください。

注意

クラウドプロバイダー間でフェデレーティッドクエリを実行するために、Azure Blog Storage データストアを接続することはできません。

9

戻る

Google Cloud PlatformGoogle Cloud Platformストレージ