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

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

在此页面上

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

本页介绍如何部署联合数据库实例以访问 Atlas 集群中的数据。

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

在开始之前,您需要:

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

  • 创建Atlas 集群(如果还没有)。 Atlas Data Federation 支持部署到 Amazon Web ServicesAzure或 Google Cloud Platform 的 Atlas 集群。

    注意

    要将 Atlas 集群用作数据存储,您必须将其部署到与联合数据库实例相同的项目中。

  • 如果尚未将数据添加到您的 Atlas 集群上的至少一个collection中,请添加数据。

要使用 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

您可以选择AmazonAmazon Web Services AzureGoogle Cloud PlatformWeb Services 、 Azure或Google Cloud Platform 。创建联合数据库实例后,您无法更改Atlas Data Federation处理查询的云提供商。

如果要查询 Atlas 集群中的数据,我们建议您选择与集群的云提供商相同的云提供商。 要查询对象存储(例如AWS S3或 Azure Blob Storage)中的数据,您必须为联合数据库实例选择与对象存储相同的云。

5

默认值为 FederatedDatabaseInstance[n]。一旦联合数据库实例被创建, 您将无法更改它的名称。

6
  • 要获得引导式体验,请单击 Visual Editor(可视化编辑器)。

  • 要编辑原始JSON ,请单击JSON Editor

7
  1. Data Sources部分选择联合数据库实例的数据集。

    单击Add Data Sources选择您的数据存储。

  2. 指定数据源。

    1. 选择Atlas Cluster ,为 Atlas 集群上的数据配置联合数据库实例。

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

    2. Provide Namespaces in this project部分中选择要用作数据存储的 Atlas 集群。

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

    3. 展开数据库并选择要添加到联合数据库实例中的集合。

      要过滤数据库和集合,请在Search database or collection字段中输入文本。 该对话框仅显示名称与搜索条件匹配的数据库和集合。

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

    4. 可选。 展开 Cluster Read Preference 部分,指定设置。

      对应 stores.[n].readPreference

      字段名称
      说明

      Read Preference Mode

      指定您想将读取请求路由到的副本集成员。 您可以从下拉列表中选取 其一:

      如果将 Atlas 集群添加为商店,则该值默认值为secondary

      如果您没有在联合数据库实例存储配置中设立任何内容,则默认值为nearest 。 要学习;了解更多信息,请参阅读取偏好模式。

      对应 stores.[n].readPreference.mode

      TagSets

      指定标签或标签规范文档列表,其中包含要将读取请求路由到的副本集节点的名称和值对。 要学习;了解更多信息,请参阅读取偏好标签集。

      对应 stores.[n].readPreference.tagSets

      Maxstaleness Seconds

      指定从节点读取的最大复制延迟或“过时时间”。 要学习;了解更多信息,请参阅读取偏好 maxStalenessSeconds。

      对应 stores.[n].readPreference.maxStalenessSeconds

    5. 单击 Next(连接)。

  3. 创建虚拟数据库、集合和视图,并将数据库、集合和视图映射到数据存储。

    1. (可选)单击对于:

      • 数据库,用于编辑数据库名称。默认值为 VirtualDatabase[n]

        databases.[n].name JSON 配置设置对应。

      • 集合,可编辑集合名称。 默认值为 VirtualCollection[n]

        databases.[n].collections.[n].name JSON 配置设置对应。

      • 视图,用于编辑视图名称。

      您可以单击:

      • Add Database 添加数据库和集合。

      • 与数据库关联, 以便将集合添加到数据库中。

      • 与集合关联,以添加关于集合的视图。 要创建视图,必须指定:

        • 视图的名称。

        • 应用于视图的管道

          视图定义管道不能包含$out$merge阶段。 如果视图定义包含嵌套管道阶段,例如$lookup$facet ,则此限制也适用于这些嵌套管道。

        要学习;了解有关视图的更多信息,请参阅:

      • 与数据库、集合或视图关联, 以便予以删除。

    2. Data Sources部分的下拉列表中选择Atlas Cluster

    3. 拖放数据存储以与集合映射。

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

Atlas 集群数据存储的配置应如下所示:

1{
2 "stores" : [
3 {
4 "name" : "<string>",
5 "provider": "<string>",
6 "clusterName": "<string>",
7 "projectId": "<string>",
8 "readPreference": {
9 "mode": "<string>",
10 "tagSets": [
11 [{"name": "<string>", "value": "<string>"},...],
12 ...
13 ],
14 "maxStalenessSeconds": <int>
15 }
16 }
17 ],
18 "databases" : [
19 {
20 "name" : "<string>",
21 "collections" : [
22 {
23 "name" : "<string>",
24 "dataSources" : [
25 {
26 "storeName" : "<string>",
27 "database" : "<string>",
28 "databaseRegex": "<string>",
29 "collection" : "<string>",
30 "collectionRegex" : "<string>",
31 "provenanceFieldName": "<string>"
32 }
33 ]
34 }
35 ],
36 "views" : [
37 {
38 "name" : "<string>",
39 "source" : "<string>",
40 "pipeline" : "<string>"
41 }
42 ]
43 }
44 ]
45}

要学习;了解有关这些配置设置的更多信息,请参阅为联合数据库实例定义数据存储。

  1. 定义Atlas数据存储。

    编辑stores用户界面中显示的JSON配置设置。 您的stores配置设置应如下所示:

    "stores" : [
    {
    "name" : "<string>",
    "provider" : "<string>",
    "clusterName" : "<string>",
    "projectId": "<string>"
    "readPreference": {
    "mode": "<string>",
    "tagSets": [
    [{"name": "<string>", "value": "<string>"},...],
    ...
    ],
    "maxStalenessSeconds": <int>
    },
    "readConcern": {
    "level": "<string>"
    }
    }
    ]

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

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

    编辑databases用户界面中显示的JSON配置设置。 您的databases配置设置应如下所示:

    "databases" : [
    {
    "name" : "<string>",
    "collections" : [
    {
    "name" : "<string>",
    "dataSources" : [
    {
    "storeName" : "<string>",
    "database" : "<string>",
    "databaseRegex": "<string>",
    "collection" : "<string>",
    "collectionRegex" : "<string>",
    "provenanceFieldName": "<string>"
    }
    ]
    }
    ]
    }
    ]

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

8

要为联合查询添加其他数据存储,请参阅:

9

后退

Atlas Cluster