/ /

使用分区属性类型

注意

指定 path 时：

指定分区属性的数据类型。
确保分区属性类型与要解析的数据类型相匹配。
使用 delimiter 中指定的分隔符。

在指定相同类型的属性时，请执行以下任一操作：

在属性之间添加常量分隔符。
使用正则表达式来描述搜索模式。要了解更多信息，请参阅不支持的解析函数。

支持的分区属性类型

下表列出了分区属性支持的数据类型、文件名以及每种数据类型的 ~databases.[n].collections.[n].dataSources.[n].path示例：

键

数据类型

例子

string

将文件名解析为字符串。

文件名： /employees/949-555-0195.json

path: /employees/{phone string}

在前面的示例中，Data Federation 将phone解释为字符串。

要学习；了解更多信息，请参阅解析文件名中的空值。

int

将文件名解析为整数。

文件名： /zipcodes/90210.json

path: /zipcodes/{zipcode int}

在前面的示例中，Data Federation 将zipcode解释为整数。

要学习；了解更多信息，请参阅解析文件名中的填充数字。

isodate

将 RFC3339 格式的文件名解析为 ISO-8601 格式日期。

文件名： /metrics/20060102.json

path: /metrics/{startTimestamp isodate}
path: /metrics/{startTimestamp isodate('20060102')}

在前面的示例中，对于第一个路径，Data Federation 会将startTimestamp解释为ISODate 。对于第二条路径，Data Federation 将startTimestamp解释为指定格式的ISODate ，并且仅匹配指定格式的文件名。

如果您未指定特定格式（如上面第一个ISODate属性路径示例所示），Atlas Data Federation 默认采用以下日期格式的分区：

1 "2006-01-02T15:04:05Z07:00"
2 "2006-01-02T15:04:05.000000Z07:00"
3 "2006-01-02"
4 "2006-01-02T15:04:05.000000-0700"
5 "2006-01-02T15:04:05-0700"
6 "2006-01-02T15:04Z07:00"
7 "2006-01-02T15:04-0700"
8 "2006-01-02Z07:00"
9 "2006-01-02-0700"
10 "2006102T15:04:05.000000Z07:00"
11 "20060102T15:04:05.000000-0700"
12 "20060102T15:04:05Z07:00"
13 "20060102T15:04:05-0700"
14 "20060102T15:04Z07:00"
15 "20060102T15:04-0700"
16 "20060102Z07:00"
17 "20060102-0700"
18 "20060102"

如果希望指定可提高性能的格式，则必须使用特殊值来指示属性在日期中的确切位置，例如日 ()、月02 012006()、年()等。要学习；了解有关用于指定日期的格式和值的更多信息，请参阅格式化时间或日期。如果指定的格式不是 RFC3339 格式，则必须使用正则表达式和特殊值来指示日期属性的位置。有关示例，请参阅从ISODate创建分区。

epoch_secs

将文件名解析为 Unix 时间戳（以秒为单位）。

文件名： /metrics/1549046112.json

path: /metrics/{startTimestamp epoch_secs}

在前面的示例中，Data Federation 将startTimestamp解释为 Unix 时间戳（以秒为单位）。

要学习；了解更多信息，请参阅解析文件名中的填充数字。

epoch_millis

将文件名解析为 Unix 时间戳（以毫秒为单位）。

文件名： /metrics/1549046112000.json

path: /metrics/{startTimestamp epoch_millis}

在前面的示例中，Data Federation 将startTimestamp解释为 Unix 时间戳（以毫秒为单位）。

要学习；了解更多信息，请参阅解析文件名中的填充数字。

objectid

将文件名解析为 ObjectId()。

文件名： /metrics/507f1f77bcf86cd799439011.json

path: /metrics/{objid objectid}

在前面的示例中，Data Federation 将 objid 解释为 ObjectId()。

uuid

将文件名解析为二进制子类型的 UUID。4

文件名： /metrics/3b241101-e2bb-4255-8caf-4136c566a962.json

path: /metrics/{myUuid uuid}

在前面的示例中， Data Federation将解释为二进制子类型myUuid 的4 UUID。

注意

Atlas Data Federation支持 Package 事务语法用于文件名路径中的正则表达式。

支持的转换

在将 path 解析为文件名时， Atlas Data Federation会将分区属性转换为BSON 类型。以后向云存储写入数据时，必须将BSON 类型转换为字符串后使用。下表显示：

分区属性类型以及Data Federation将其转换为的BSON类型。
BSONstring要转换为字符串以便稍后写入云存储的BSON数据类型。

分区属性类型	已解析的BSON类型	源BSON类型
`string`	UTF-8 字符串 null*	UTF-8 字符串 null
`int`	64 位整型 null	32 位整数 64 位整型 null（作为没有填充的字符串）
`isodate`	UTC 日期时间 null	UTC 日期时间（作为 ISO-8601 格式字符串） null
`objectid`	`ObjectId()` null	`ObjectId()` （作为具有十六进制编码的 string） null
`uuid`	BSON 二进制数据子类型 4 (UUID) null	BSON 二进制数据子类型 4 (UUID) null