为联合数据库实例配置数据存储

本页包含可用于设立、更新和检索联合数据库实例存储配置的常规命令。对于特定的数据存储配置，例如 AWS S3 加密，请参阅其特定的数据存储文档。

为联合数据库实例定义数据存储

要为联合数据库实例配置数据存储，您需要创建一个存储配置JSON文件，该文件定义您的数据存储并将其映射到您可以查询的集合。MongoDB为以下数据存储提供联合数据库实例支持：

重要

存储配置中的信息在MongoDB内部可见，并存储为操作数据，以监控和提高Atlas Data Federation的性能。我们建议您不要在配置中使用 PII。

数据访问类型

创建联合数据库实例时，您可以授予Atlas对您的 AWS 账户中的 AWS 存储桶进行以下类型数据访问的权限之一。

只读访问权限：无法对数据进行任何更改或添加新数据。
写入访问权限：可以更新现有文件、删除文件或向存储添加新数据。

为了访问您的 Atlas 集群，Atlas 使用您现有的基于角色的访问控制。您可以按照自管理部署中的用户和角色中的步骤查看和编辑用户的访问权限。

特权操作

权限操作是可以对联合数据库实例执行的操作。您可以通过以下方式之一授予权限操作：

从 Atlas 用户界面创建或修改自定义角色时
在actions.action 请求正文参数中，当您从 Atlas API 创建或更新自定义角色时

下表显示可用的联合数据库实例权限操作：

命令	说明
`sqlGetSchema`	要检索为集合或视图存储的模式，请参阅使用 `mongosh` 查看模式以了解详细信息。
`sqlSetSchema`	设置或删除集合或视图的模式，请参阅使用 `mongosh` 查看模式，了解详细信息。
`viewAllHistory`	使用$queryHistory 检索过去运行的查询的详细信息。
`outToAzure`	使用 $out 将数据从任何一个受支持的联合数据库实例存储或多个受支持的联合数据库实例存储写入您的 Azure Blob 存储容器。
`outToS3`	使用 $out 将数据从任何一个受支持的联合数据库实例存储或多个受支持的联合数据库实例存储写入 S 存储桶。3
`outToGCP`	使用 $out 将数据从任何一个受支持的联合数据库实例存储或多个受支持的联合数据库实例存储写入 Google Cloud Storage 存储桶。
`storageGetConfig`	使用 storageGetConfig 命令检索联合数据库实例存储配置。
`storageSetConfig`	使用 storageSetConfig 命令设置或更新您的联合数据库实例存储配置。

检索配置文件

要检索联合数据库实例配置文件，请连接到您的实例并使用以下命令：

use admin
db.runCommand( { "storageGetConfig" : 1 } )

该命令会返回当前联合数据库实例配置。

验证配置文件

要验证联合数据库实例配置，请连接到您的实例并使用以下命令：

use admin
db.runCommand( { "storageValidateConfig" : <config> } )

将<config>替换为联合数据库实例的配置。

如果配置有效，该命令将返回以下回答：

{ "ok" : 1 }

如果配置无效，该命令将在 errs字段中返回错误列表：

{
       "ok" : 1,
       "errs" : [
               "<error>",
               "<error>",
               ...
       ]
}

更新联合数据库实例配置

要更新联合数据库实例配置，请连接到您的实例并使用以下命令：

use admin
db.runCommand( { "storageSetConfig" : <config> } )

将<config>替换为联合数据库实例的配置。

提示

MongoDB建议您在应用任何更改之前验证联合数据库实例配置。

要更新联合数据库实例配置数据存储、数据源、数据库、集合和视图，请执行以下步骤：

登录MongoDB Atlas

从左侧的 Services 中选择 Data Federation 选项

单击联合数据库实例名称旁边的 Configuration 按钮

在右上角选择您首选的配置界面方法

对于可视化界面，请单击 Visual。
要直接在JSON文件中进行编辑，请单击 JSON Editor。

对联合数据库实例存储配置进行更改。

管理数据源

添加其他数据源

与 stores JSON 配置设置对应。

单击 Add Data Store Sources（连接）。
选择要配置的数据源提供商：- 对于 AWS S3，请继续执行部署联合数据库实例数据存储中的步骤 5。- 对于 Google Cloud，请继续执行部署联合数据库实例数据存储中的步骤 7。- 对于 Azure，请继续执行部署联合数据库实例数据存储中的步骤 7。- 对于Atlas集群，请继续执行部署联合数据库实例存储中的步骤 7。- 对于 HTTP 存储，请继续执行“部署联合数据库实例数据存储”中的步骤 7。- 对于 Atlas Online Archive，请继续执行部署联合数据库实例存储的第 7 步。

编辑数据源名称

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

从左侧列表中选择数据存储源。
单击编辑商店名称图标。
在“数据存储名称”字段中更改当前名称。
单击“完成”。

删除数据源

从左侧列表中选择您的数据存储源
单击 删除此应用商店 图标
单击“删除”按钮。

管理数据库

创建新数据库

与 databases JSON 配置设置对应。

单击右上角的“添加数据库”按钮
填写数据库名称字段
填写集合名称字段
单击“创建”按钮

编辑数据库名称

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

从列表中选择您的数据库。
单击“编辑数据库名称”图标。
更新数据库名称。
单击完成按钮。

删除数据库

从列表中选择您的数据库。
单击“删除此数据库”图标。
单击“删除”按钮。

管理集合

在数据库中创建新集合

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

选择要从中创建集合的数据库
单击 添加集合 图标
填写集合名称字段
单击“创建”按钮

编辑集合名称

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

从列表中选择您的集合
单击 “编辑集合名称” 图标
将集合名称字段中的当前名称更改为新名称
单击“创建”按钮

删除集合

从列表中选择您的集合
单击 删除此集合 图标
单击“删除”按钮。

管理视图

在集合中创建新视图

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

选择要从中创建视图的集合
单击添加视图图标
填写视图名称字段
填写管道 </core/aggregation-pipeline/>字段
单击“创建”按钮

编辑视图名称或管道

分别对应于databases.[n].views.[n].name和databases.[n].views.[n].pipeline JSON配置设置。

从集合中选择视图
单击 “编辑视图名称” 图标
将“视图名称”字段中的当前名称更改为新名称
在管道字段中将当前管道更改为新管道
单击“保存”按钮

删除视图

从列表中选择您的视图
单击删除此视图图标
单击“删除”按钮。

编辑JSON配置文件对象以添加、创建或删除stores、databases 或 views

要学习；了解有关特定数据存储提供商的配置设置的更多信息，请参阅其“配置文件”页面：

要学习如何使用MongoDB Shell (mongosh)设定和管理存储配置，请参阅页面管理联合数据库实例。

生成通配符集合

重要

通配符集合功能仅适用于来自 AWS S3 和 Atlas 集群的数据源。

使用来自 AWS S3 或 Atlas 集群的数据源时，您可以动态设置映射到数据的集合名称。要生成集合名称，请在联合数据库实例存储配置中指定通配符 * 作为集合名称设置的值。

提示

您可以使用 storageSetConfig 命令为生成通配符 (*) 集合配置相应的设置。

后退

高级用户配置

来年

部署数据存储