RequestOptions.PartitionKey Propriedade

Referência

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

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

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.

Aplica-se a

Partilhar via