Docs 菜单
Docs 主页
/
MongoDB Atlas
/ / /

部署一个联合数据库实例。

在此页面上

  • 必需的访问权限
  • 先决条件
  • 步骤

本页介绍如何部署联合数据库实例来访问GoogleGoogle Cloud Platform Cloud Platform存储桶中的数据。

要部署联合数据库实例,您必须对项目拥有 Project Owner访问权限。 在部署联合数据库实例之前,具有Organization Owner访问权限的用户必须将自己作为Project Owner添加到项目中。

在开始之前,您需要:

  • 创建一个 MongoDB Atlas帐户(如果您还没有帐户)。

  • 安装 gcloud CLI。

  • 配置 gcloudCLI CLI以访问权限您的Google CloudGoogle Cloud Platform Platform帐户。或者,您必须有权访问权限GoogleGoogle Cloud Platform Cloud Platform控制台并有权创建 IAM 角色。

  • 可选。 Google Cloud Platform设置Google Cloud Platform服务帐户。

要使用 Atlas CLI 创建新的 Data Federation 数据库,请运行以下命令:

atlas dataFederation create <name> [options]

要学习;了解有关命令语法和参数的更多信息,请参阅Atlas CLI AtlasdataFederation create 的 文档。

提示

请参阅:相关链接

1
2
3
  1. 点击 Create New Federated Database(新建联合数据库)下拉列表。

  2. 选择 Manual Setup

4

您可以选择Amazon Web Services AzureGoogle Cloud PlatformAmazon 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 Storage选择Google Cloud Platform ,为Google Cloud Platform存储桶中的数据配置联合数据库实例。

    stores.[n].provider JSON 配置设置对应。

  3. 为Atlas选择一个Google Google Cloud PlatformCloud Platform服务帐户。Atlas

    Google Cloud Platform您可以从角色选择下拉列表中选择Atlas已获得授权的现有Google Cloud Platform服务帐户,也可以选择Atlas Create a Google Service Account

    如果您选择了Atlas已获得授权的现有帐户,请单击 并继续下一步,列出您的GoogleAtlas NextGoogle Cloud PlatformCloud Platform存储桶。

    如果要创建新的服务帐户,请选择 Create a Google Service Account 并单击 Next

  4. Configure Google Cloud Storage 模式中,按照提供的说明配置Google Cloud Platform CLIGoogle Cloud PlatformCLI Next,然后单击 。

  5. 配置Google Cloud PlatformGoogle Cloud Platform Storage。

    1. 输入您的GoogleGoogle Cloud Platform Cloud Platform存储桶的名称。

      对应于stores.[n].bucket JSON配置设置。

    2. 指定存储桶是Read-only还是同时是Read and write

      AtlasRead-onlyAtlas只能查询 存储桶;如果您希望查询并将查询结果保存到GoogleGoogle Cloud Platform Cloud Platform存储桶,请选择Read and write

    3. 选择GoogleGoogle Cloud Platform Cloud Platform Storage 存储桶的地区。

      对应于stores.[n].region JSON配置设置。

      注意

      Atlas Data Federation如果AtlasGCP Data Federation无法检索指定GCP存储桶的地区,则无法创建联合数据库实例。

    4. 授予对GoogleGoogle Cloud Platform Cloud Platform项目的访问权限。

      1. Google Cloud Platform在托管GoogleGoogle Cloud Platform Cloud Platform存储桶的项目的Google Cloud Platform控制台中,导航到IAM and Admin ,然后导航到IAM

      2. 单击 Grant AccessNew principals在出现的模式中,在Google Cloud Platform 字段,输入与您的联合数据库实例关联的Google Cloud Platform服务帐户。

      3. 要授予存储桶只读访问权限,请应用storage.viewer角色。要授予对存储桶的读写访问权限,请另外应用storage.editor角色。

    5. 可选。指定DataData Federation Federation在GoogleGoogle Cloud Platform Cloud Platform存储桶中搜索文件时应使用的前缀。如果省略,Data Federation Google Cloud PlatformData Federation将从Google Cloud Platform Storage 存储桶的根目录开始递归搜索所有文件。

      对应于stores.[n].prefix JSON配置设置。

    6. 单击 Validate and finish.

  6. 为GoogleGoogle Cloud Platform Cloud Platform Storage 存储桶中的文件定义路径结构,然后单击Next

    例如:

    https://storage.googleapis.com/<path>/<to>/<files>/<filename>.<file-extension>

    要为Google CloudGoogle Cloud Platform Add Data SourcePlatform存储桶上的数据添加其他路径,请单击 并输入路径。要学习;了解有关路径的更多信息,请参阅为 S3 数据定义路径。

    对应于databases.[n].collections.[n].dataSources.[n].path JSON配置设置。

  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 配置设置对应。

GoogleGoogle Cloud Platform 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用户界面中显示的JSON配置设置。 您的stores配置设置应如下所示:

    "stores" : [
    {
    "name" : "<string>",
    "provider" : "<string>",
    "region" : "<string>",
    "bucket" : "<string>",
    "additionalStorageClasses" : ["<string>"],
    "prefix" : "<string>",
    "delimiter" : "<string>",
    "includeTags": <boolean>,
    "public": <boolean>
    }
    ]

    要学习;了解有关这些配置设置的更多信息,请参阅stores

  2. 定义联合数据库实例虚拟数据库、集合和视图。

    编辑databases用户界面中显示的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 Blob 存储数据存储来跨云提供商运行联合查询

9

后退

Google Cloud PlatformGoogle Cloud Platform存储