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

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

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

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

重要

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

数据访问类型

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

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

To access your Atlas clusters, Atlas uses your existing Role Based Access Controls. You can view and edit the acces of your user following the steps in Manage Users and Roles on Self-Managed Deployments.

特权操作

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

从 Atlas 用户界面创建或修改自定义角色时
In the actions.action request body parameter when you create or update a custom role from the Atlas API

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

命令	说明
`sqlGetSchema`	Retrieve the schema stored for a collection or view, see sqlGetSchema for details.
`sqlSetSchema`	Set or delete the schema for a collection or view, see sqlGetSchema for details.
`viewAllHistory`	使用$queryHistory 检索过去运行的查询的详细信息。
`outToAzure`	Write data from any one of the supported federated database instance stores or multiple supported federated database instance stores to your Azure Blob Storage container using $out.
`outToS3`	使用 $out 将数据从任何一个受支持的联合数据库实例存储或多个受支持的联合数据库实例存储写入 S3 存储桶。
`outToGCP`	Write data from any one of the supported federated database instance stores or multiple supported federated database instance stores to your Google Cloud Storage bucket using $out.
`storageGetConfig`	Retrieve your federated database instance storage configuration using the storageGetConfig command.
`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（连接）。
选择要配置的数据源提供商：- 对于 Amazon Web Services S3，继续执行部署联合数据库实例数据存储的第 5 步。- 对于 Google Cloud Platform，继续执行部署联合数据库实例数据存储中的第 7 步。- 对于 Azure，继续执行部署联合数据库实例数据存储中的第 7 步。- 对于 Atlas 集群，继续执行部署联合数据库实例数据存储中的第 7 步。- 对于 HTTP 数据存储，继续执行部署联合数据库实例数据存储中的第 7 步。

编辑数据源名称

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

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

删除数据源

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

管理数据库

创建新数据库

与 databases JSON 配置设置对应。

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

编辑数据库名称

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

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

删除数据库

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

管理集合

在数据库中创建新集合

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

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

编辑集合名称

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

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

删除集合

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

管理视图

Create a new View in a Collection

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

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

编辑视图名称或管道

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

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

删除视图

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

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

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

生成通配符集合

重要

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

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

提示

You can use the storageSetConfig command to configure the settings for generating wildcard (*) collections.