你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
文档
Azure Cosmos DB 是一个全球分布式多模型数据库，支持文档、图形和键值数据模型。 本部分中的内容用于通过 REST 使用 SQL API 创建、查询和管理文档资源。
文档资源在 Azure Cosmos DB 资源模型中由 docs 表示。 文档包含 JSON 格式的用户定义内容。 除了所需的 ID 属性之外，用户可以定义内容的任何任意元素、结构和层次结构。 ID 元素是用户可设置的唯一字符串，不能超过 255 个字符。 可以插入、替换、删除、读取、枚举和查询集合中的任意 JSON 文档。
Azure Cosmos DB 不需要任何架构或辅助索引即可支持查询集合中的文档。 默认情况下，文档以一致的方式自动编制索引，从而使文档在创建后立即可查询。
- 文档存储在集合中。 有关集合的详细信息，请参阅 集合。
- 一个文档可以包含一个或多个附件。 有关附件的详细信息，请参阅 附件。
- 用户对文档的访问可以通过权限进行管理。 有关权限的详细信息，请参阅 权限。
此示例 JSON 文档显示了集合中火山的条目。 条目包括火山名称、位置信息（包括地理空间数据）以及系统定义的元素（如_rid、_ts、_self、_etag和_attachments）。
{
"Volcano Name": "Agua de Pau",
"Country": "Portugal",
"Region": "Azores",
"Location": {
"type": "Point",
"coordinates": [
-25.47,
37.77
]
},
"Elevation": 947,
"Type": "Stratovolcano",
"Status": "Historical",
"Last Known Eruption": "Last known eruption from 1500-1699, inclusive",
"id": "d44c94b6-81f8-4b27-4970-f79b149529d3",
"_rid": "Sl8fALN4sw4BAAAAAAAAAA==",
"_ts": 1448049512,
"_self": "dbs/Sl8fAA==/colls/Sl8fALN4sw4=/docs/Sl8fALN4sw4BAAAAAAAAAA==/",
"_etag": "\"0000443f-0000-0000-0000-564f7b680000\"",
"_attachments": "attachments/"
}
| 属性 | 说明 |
|---|---|
| id | 必需。 它是用户可设置的属性。 它是标识文档的唯一名称，也就是说，逻辑分区中没有两个文档共享相同的 ID。 分区和 ID 唯一标识数据库中的项。 ID 字段不能超过 255 个字符。 |
| _摆脱 | 它是系统生成的属性。 资源 ID (_rid) 是一个唯一标识符，也是按资源模型上的资源堆栈分层的标识符。 它在内部用于文档资源的放置和导航。 |
| _ts | 它是系统生成的属性。 它指定资源的上次更新时间戳。 高值是一个时间戳。 |
| _自我 | 它是系统生成的属性。 它是资源的唯一可寻址 URI。 |
| _Etag | 它是一个系统生成的属性，指定乐观并发控制所需的资源 etag。 |
| _附件 | 它是一个系统生成的属性，用于指定附件资源的可寻址路径。 |
任务
可以使用文档执行以下任务：