RequestOptions.PartitionKey Propriedade

Definição

Namespace:

Microsoft.Azure.Documents.Client

Assemblies:

Microsoft.Azure.DocumentDB.Core.dll, Microsoft.Azure.Documents.Client.dll

Pacotes:

Microsoft.Azure.DocumentDB v2.18.0, Microsoft.Azure.DocumentDB.Core v2.18.0

Obtém ou define o PartitionKey para a solicitação atual no serviço do Azure Cosmos DB.

public Microsoft.Azure.Documents.PartitionKey PartitionKey { get; set; }

member this.PartitionKey : Microsoft.Azure.Documents.PartitionKey with get, set

Public Property PartitionKey As PartitionKey

Valor da propriedade

PartitionKey

Exemplos

O exemplo a seguir mostra como ler um documento em uma coleção particionada usando PartitionKey. O exemplo pressupõe que a coleção seja criada com uma PartitionKeyDefinition da propriedade 'id' em todos os documentos.

await client.ReadDocumentAsync(
    document.SelfLink,
    new RequestOptions { PartitionKey = new PartitionKey(document.Id) } );

Comentários

A chave de partição é usada para identificar a partição de destino para essa solicitação. Ele deve ser definido em operações de leitura e exclusão para todas as solicitações de documento; criar, ler, atualizar e excluir operações para todas as solicitações de anexo de documento; e execute a operação em produção armazenada.

Para operações de criação e atualização em documentos, a chave de partição é opcional. Quando ausente, a biblioteca de clientes extrairá a chave de partição do documento antes de enviar a solicitação para o servidor.

Confira também

• DocumentCollection
• PartitionKeyDefinition