配置 Online Archive

AtlasGoClusters在Atlas中，Go项目的 页面。

1. 如果尚未显示，请从导航栏上的 Organizations 菜单中选择包含所需项目的组织。

2. 如果尚未显示，请从导航栏的Projects菜单中选择所需的项目。

3. 如果尚未出现，请单击侧边栏中的 Clusters（集群）。

   会显示集群页面。

Go集群的Online Archive 页面。

1. 单击集群的名称。

2. 单击 Online Archive 标签页。

   显示Online 存档 （在线存档）页面。

开始配置集合在线存档。

要为您的集合配置 Online Archive，请单击：

• Configure Online Archive 按钮。

• Add Archive 按钮（随后单击）。

查看 Online Archive Overview并单击 Next继续。

Archiving Rule通过提供以下信息来创建 。

1. 在 Namespace 字段中指定集合命名空间，其中包括数据库名称、点 (.) 分隔符和集合名称（即 <database>.<collection>）。

   Online Archive 一旦创建，就无法修改命名空间。

2. 选择您要存储存档数据的云提供商地区。

   提示

   我们建议您尽可能选择与集群相同的区域，因为如果选择不同的区域，可能会产生更高的数据传输成本。

   Atlas 根据部署集群的云提供商显示云提供商地区。对于多云集群，Atlas 显示最高优先级提供商的云提供商地区。Atlas 会在与您的集群部署地区相近或完全匹配的地区旁边显示 。

   AWS

   AZURE

   GCP

   对于部署在 AWS 上的 Atlas 集群，您可以选择以下地区之一：

   Data Federation 区域	AWS 区域
   Virginia, USA	us-east-1
   美国俄勒冈州	us-west-2
   巴西圣保罗	sa-east-1
   爱尔兰	eu-west-1
   英国伦敦	eu-west-2
   德国法兰克福	eu-central-1
   Tokyo, Japan	ap-northeast-1
   印度孟买	ap-south-1
   新加坡	ap-southeast-1
   澳大利亚悉尼	亚太东南部-2
   加拿大蒙特利尔	ca-central-1

   对于在Azure上部署的Atlas集群，只有当集群上没有使用其他云提供商的其他在线存档时，您才能选择Azure地区。 如果集群上的现有 Online 存档使用Amazon Web Services或Google Cloud Platform存储存档数据，则您只能为该集群上的任何新 Online Archive 选择Amazon Web Services或Google Cloud Platform地区。

   注意

   对于在Azure上部署的集群，如果您有使用Amazon Web Services或Google Cloud Platform的现有 Online Archive，并且您将其删除，则必须等待五天才能创建使用Azure的新 Online 存档 。 在此五天内，任何创建新 Online 存档的尝试仍默认为您最初选择的云提供商。

   对于部署在 Azure 上的 Atlas 集群，您可以选择以下地区之一：

   Data Federation 区域	Azure 地区
   Virginia, USA	US_EAST_2
   荷兰	EUROPE_WEST

   AtlasGoogle Cloud Platform对于部署在Google Cloud Platform 上的 集群，只有当集群上没有使用其他云提供商的其他 Online Archive 时，您才能选择 地区。如果集群上的现有 Online 存档使用Amazon Web Services或Azure来存储存档数据，则您只能为该集群上的任何新 Online Archive 选择Amazon Web Services或Azure区域。

   注意

   对于部署在Google Cloud Platform上的集群，如果您有使用Amazon Web Services或Azure的现有 Online Archive，而您将其删除，则必须等待五天才能创建使用Google Cloud Platform的新 Online 存档 。 在此五天内，任何创建新 Online 存档的尝试仍默认为您最初选择的云提供商。

   Atlas对于部署在 上的Google Cloud Platform 集群，您可以选择以下区域之一：

   Data Federation 区域	Google Cloud 地区
   比利时	europe-west1
   Iowa, USA	us-central1

   注意

   Atlas 创建在线存档后，您将无法修改存储区域。

3. 为要存档的收藏类型指定选择要存档的文档所依据的标准。

   标准集合

   时间序列集合

   对于标准集合，请在 Atlas 用户界面的 Date Match 或 Custom Criteria 标签页下指定选择要存档的文档的条件。

   日期匹配

   自定义标准

   要使用日期字段和天数的组合从集合选择文档，请执行以下操作：

   • 指定集合中文档中已建立索引的日期字段。 要指定嵌套字段，请使用点表示法。

   • 指定数据在 Atlas 集群中保留的天数。

   • 选择指定日期字段的日期格式。

     如果选择以下任一格式，则指定日期字段的值必须为BSON类型long ：

     • EPOCH_SECONDS

     • EPOCH_MILLIS

     • EPOCH_NANOSECONDS

     重要

     创建在线存档后，您将无法修改日期字段。

   要使用自定义过滤从集合中选择文档，请指定要运行的有效JSON过滤。 Atlas将指定的自定义过滤与db. 集合.find(过滤) 命令。 不能使用空文档参数 ( {} ) 返回所有文档。 您可以使用MongoDB Atlas操作符（例如$expr ）来利用所有聚合操作符，如以下示例所示。

   注意

   以下示例假定所有文档都包含具有日期时间值的bucket_end_date字段。 在以下示例中， Atlas存档所有不包含bucket_end_date字段的文档以及bucket_end_date不是日期时间值的所有文档。

   例子

   在此自定义过滤示例中，当当前日期超过文档中bucket_end_date字段中的日期时， Atlas会从当前日期中减去 30 天（以毫秒为单位），然后在经过这么多天、小时和分钟后存档数据。

   {
     "$expr": { "$lte": [
       "$bucket_end_date",
       { "$subtract": [ "$$NOW", 2592000000 ] }
     ] }
   }

   在此自定义过滤示例中，当当前日期超过objectId内的日期时， Atlas会从当前日期中减去 30 天（以毫秒为单位），然后在经过这么多天、小时和分钟后存档数据。

   {
     "$expr": {
       "$lte": [
         {"$toDate": "$_id"},
         { "$subtract": [ "$$NOW", 2592000000 ] }
       ]
     }
   }

   如果您在自定义过滤中使用$expr ，有时Atlas 集群可能无法使用索引来存档数据。

   注意

   $NOW 仅在运行MongoDB 4.2或更高版本的Atlas集群上支持。

   要存档时间序列集合中的文档，请选中This is a Time-Series Collection复选框并指定以下内容：

   • 包含每个时间序列文档中日期的字段的名称。 它必须与时间序列集合中的timeField相对应。 要指定嵌套字段，请使用点表示法。 创建在线存档后，您将无法修改时间字段。

   • 在Atlas 集群中保留数据的天数。

   • 指定日期字段的日期格式。 日期字段值必须采用ISODate格式。

   注意

   Atlas 运行索引充分性查询以确定存档过程的效率。如果扫描的文档数与返回的文档数之间的差值为 10 个或更多个，则查询结果会触发 Index Sufficiency Warning（索引充分性警告）。此警告表明您的索引不足，无法实现有效的存档过程。对于基于日期的存档，您必须为日期字段创建索引。对于使用表达式的自定义条件，Atlas 可能会先转换一个值，然后再根据查询对其进行评估。

指定您希望在在线存档中存储数据的天数，以及您希望Atlas运行存档作业的时间窗口。

1. （可选）指定 Deletion Age Limit（删除期限限制）。

   默认情况下，Atlas 不会删除存档数据。但是，如果您指定 Deletion Age Limit（删除期限限制），则可以在 7 到 9125 天（25 年）的范围内指定存档数据保留期限。Atlas 会在您在指定的天数后删除存档数据。该数据过期规则在您设置 Deletion Age Limit（删除期限限制）的 24 小时后生效。

   警告

   Atlas 删除数据后，您将无法恢复数据。

2. （可选）指定 Schedule Archiving Window（删除期限限制）。

   默认情况下，Atlas 会定期运行查询来存档数据。不过，您可以切换Schedule Archiving Window以明确安排您希望 Atlas 存档数据的时间窗口。您可以指定以下内容：

   • 频率。您可以选择每天、一周中的特定日期或每月的特定日期运行作业。如果您希望将数据存档作业安排在每月 29 日、30 日或 31 日，则 Atlas 在没有这些日期的月份（例如二月）不会运行存档作业。

   • 时间窗口，以小时为单位。选择您希望 Atlas 运行数据归档作业的时间段。您必须指定至少两个小时。如果正在运行的作业在时间窗口内未完成，Atlas 会继续运行作业直到完成。

Next单击 指定最常查询的字段。

指定集合中两个最常查询的字段，以在 Online Archive 中创建分区。

/title/plot/released

/genres/title

/title/plot/released

• 选择仅包含Amazon Web Services支持的字符的字段。 要详细学习；了解应避免使用的字符，请参阅 创建对象键名称 。Atlas会跳过且不会存档包含不受支持的字符的文档。

• 选择不包含多态数据的字段。Atlas 从集合中抽取 10 个文档，以确定分区字段的数据类型。如果文档中指定的字段值与同一集合中其他文档中的值不匹配，则 Atlas 不会将文档存档。

• 选择您经常查询的字段，并从第一个位置查询次数最多的字段到最后一个位置查询次数最少的字段进行排序。 例如，如果您经常查询日期字段，则将日期字段保留在第一个位置。但如果您经常查询另一个字段，则该字段应该位于第一个位置。

Atlas支持以下分区属性类型：

• date

• double

• int

• long

• objectId

• string

• boolean

如需详细了解支持的分区属性类型，请参阅分区属性类型。

虽然分区可以提高查询性能，但不包含这些字段的查询需要对所有存档文档进行全面集合扫描，这将花费更长时间并增加成本。 要了解有关分区如何提高 Atlas Data Federation 查询性能的更多信息，请参阅 S3 中的数据结构。

单击 Next 以查看并确认在线存档设置。 您可以查看以下存档规则设置：

• 数据库和集合的名称

• 云提供商名称和云提供商区域

• 日期字段的名称（仅适用于Date Match）

• 在 Atlas 集群上保留数据的天数（仅适用于 Date Match）

• 删除存档数据的天数

• 存档数据的频率和时间窗口

• 用于识别存档数据的自定义查询（仅适用于 Custom Criteria）

• 分区字段

如果需要，请单击Back编辑这些设置。

复制并在mongosh shell中运行显示的查询，查看与您在步骤 5 中定义的规则条件相匹配的文档。 您可以对查询运行解释以检查它是否使用索引。 如果字段未编制索引，请继续执行下一步以创建索引。 如果字段已编制索引，请跳到步骤11 。

（可选）在mongosh 中复制并运行显示的查询，以创建所需的索引。这可确保对数据进行索引以获得最佳性能。

验证并确认存档规则。

1. 在 Confirm an online archive 标签页中单击 Begin Archiving。

2. 单击 Begin Archiving（开始存档）窗口中的 Confirm（确认）。