Documentos
O Azure Cosmos DB é uma base de dados com vários modelos distribuída globalmente que suporta os modelos de dados de documentos, gráficos e chave-valor. O conteúdo desta secção destina-se a criar, consultar e gerir recursos de documentos com a API SQL através do REST.
O recurso do documento é representado pelo docs no modelo de recursos do Azure Cosmos DB. Um documento consiste em conteúdos definidos pelo utilizador no formato JSON. Além da propriedade ID necessária, os utilizadores podem definir quaisquer elementos arbitrários, estruturas e hierarquias para o conteúdo. O elemento ID é uma cadeia exclusiva que é definida pelo utilizador e não pode exceder os 255 carateres. Pode inserir, substituir, eliminar, ler, enumerar e consultar documentos JSON arbitrários numa coleção.
O Azure Cosmos DB não necessita de qualquer esquema ou índice secundário para suportar a consulta através de documentos numa coleção. Por predefinição, os documentos são automaticamente indexados e indexados de forma consistente, tornando assim que um documento pode ser consultado assim que é 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 utilizador a documentos pode ser gerido através de permissões. Para obter mais informações sobre permissões, veja Permissões.
Este documento JSON de exemplo mostra a entrada de um vulcão numa 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ório. É uma propriedade settable do utilizador. É o nome exclusivo que identifica o documento, ou seja, nenhum documento partilha o mesmo ID numa partição lógica. A partição e o ID identificam exclusivamente um item na base de dados. O campo ID não pode exceder os 255 carateres. |
| _rid | É uma propriedade gerada pelo sistema. O ID do recurso (_rid) é um identificador exclusivo que também é hierárquico de acordo com a pilha de recursos no modelo de recursos. É utilizado 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. |
| _self | É uma propriedade gerada pelo sistema. É o URI endereçável exclusivo para o recurso. |
| _etag | É uma propriedade gerada pelo sistema que especifica a etag de recursos necessária para o controlo de simultaneidade otimista. |
| _attachments | É uma propriedade gerada pelo sistema que especifica o caminho endereçável para o recurso de anexos. |
Tarefas
Pode efetuar as seguintes tarefas com documentos: