你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

文档

2025-05-07

Azure Cosmos DB 是一个全球分布式多模型数据库，支持文档、图形和键值数据模型。本部分中的内容用于通过 REST 使用 SQL API 创建、查询和管理文档资源。

文档资源在 docs Azure Cosmos DB 资源模型中表示。文档由 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/"  
}

资产	DESCRIPTION
`id`	必填。它是用户可设置的属性。它是标识文档的唯一名称，即两个文档在逻辑分区中共享相同的 ID。分区键和 `id` 字段唯一标识数据库中的项。 ID 字段不得超过 255 个字符。
`_rid`	它是系统生成的属性。资源 ID （_rid）是一个唯一标识符，也是资源模型上每个资源堆栈的分层标识符。它在内部用于文档资源的放置和导航。
`_ts`	它是系统生成的属性。它指定资源的上次更新时间戳。该值是时间戳。
`_self`	它是系统生成的属性。它是资源的唯一可寻址 URI。
`_etag`	它是一个系统生成的属性，指定乐观并发控制所需的资源 etag。
`_attachments`	它是一个系统生成的属性，它指定附件资源的可寻址路径。

任务

可以使用文档执行以下任务：

通过

文档

任务

另请参阅

其他资源