Documentos
O Azure Cosmos DB é um banco de dados multimodelo distribuído globalmente que dá suporte aos modelos de dados de documento, grafo e chave-valor. O conteúdo nesta seção destina-se à criação, consulta e gerenciamento de recursos de documento usando a API do SQL por meio do REST.
O recurso de documento é representado pelo docs no modelo de recurso do Azure Cosmos DB. Um documento consiste em conteúdo definido pelo usuário no formato JSON. Além da propriedade ID necessária, os usuários podem definir quaisquer elementos arbitrários, estruturas e hierarquias para o conteúdo. O elemento ID é uma cadeia de caracteres exclusiva que é configurável pelo usuário e não deve exceder 255 caracteres. Você pode inserir, substituir, excluir, ler, enumerar e consultar documentos JSON arbitrários em uma coleção.
O Azure Cosmos DB não requer nenhum esquema ou índice secundário para dar suporte à consulta em documentos em uma coleção. Por padrão, os documentos são automaticamente e indexados de maneira consistente, tornando um documento consultável assim que ele é criado.
- Os documentos são armazenados em coleções. Para obter mais informações sobre coleções, consulte Coleções.
- Um documento pode conter um ou mais anexos. Para obter mais informações sobre anexos, consulte Anexos.
- O acesso do usuário a documentos pode ser gerenciado por meio de permissões. Para obter mais informações sobre permissões, consulte Permissões.
Este documento JSON de exemplo mostra a entrada de um vulcão em uma coleção. A entrada inclui o nome do vulcão, informações de localização, incluindo dados geoespaciais e elementos definidos pelo sistema, como _rid, _ts, _self, _etag e _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/"
}
| Propriedade | Descrição |
|---|---|
| id | Obrigatórios. É uma propriedade configurável pelo usuário. É o nome exclusivo que identifica o documento, ou seja, nenhum documento compartilha a mesma ID dentro de uma partição lógica. A partição e a ID identificam exclusivamente um item no banco de dados. O campo id não deve exceder 255 caracteres. |
| _Livrar | É uma propriedade gerada pelo sistema. A ID do recurso (_rid) é um identificador exclusivo que também é hierárquico de acordo com a pilha de recursos no modelo de recurso. Ela é usada internamente para posicionamento e navegação do recurso de documento. |
| _Ts | É uma propriedade gerada pelo sistema. Especifica o último carimbo de data/hora atualizado do recurso. O valor é um carimbo de data/hora. |
| _Auto | É uma propriedade gerada pelo sistema. É o URI endereçável exclusivo do recurso. |
| _Etag | É uma propriedade gerada pelo sistema que especifica a etag de recurso necessária para o controle de simultaneidade otimista. |
| _Anexos | É uma propriedade gerada pelo sistema que especifica o caminho endereçável para o recurso de anexos. |
Tarefas
Você pode realizar as seguintes tarefas com documentos: