Partilhar via

Documentos

O Azure Cosmos DB é um banco de dados multimodelo distribuído globalmente que dá suporte aos modelos de dados de documento, gráfico e chave-valor. O conteúdo desta seção é para criar, consultar e gerenciar recursos de documentos usando a API SQL via REST.

O recurso de documento é representado por docs no modelo de recursos 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, estruturas e hierarquias arbitrárias para o conteúdo. O elemento ID é uma cadeia de caracteres exclusiva que pode ser definida 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 índices secundários para dar suporte à consulta sobre documentos em uma coleção. Por padrão, os documentos são automaticamente indexados de maneira consistente, tornando um documento consultável assim que é criado.

  • Os documentos são armazenados dentro de 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 aos documentos pode ser gerenciado por meio de permissões. Para obter mais informações sobre permissões, consulte Permissões.

Este exemplo de documento JSON 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ório É uma propriedade configurável pelo usuário. É o nome exclusivo que identifica o documento, ou seja, não há dois documentos que compartilham o mesmo ID dentro de uma partição lógica. A chave de partição e id o campo identificam exclusivamente um item no banco de dados. O campo id não deve exceder 255 caracteres.
_rid É uma propriedade gerada pelo sistema. O ID do recurso (_rid) é um identificador exclusivo que também é hierárquico pela pilha de recursos no modelo de recursos. Ele é usado internamente para posicionamento e navegação do recurso do documento.
_ts É uma propriedade gerada pelo sistema. Ele 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 o etag de recurso necessário para o controle de simultaneidade otimista.
_attachments É uma propriedade gerada pelo sistema que especifica o caminho endereçável para o recurso de anexos.

Tarefas

Você pode executar as seguintes tarefas com documentos:

Ver também

  • Last updated on