CosmosItemRequestOptions Classe

public CosmosItemRequestOptions()

Construtor

public ConsistencyLevel getConsistencyLevel()

Obtém o nível de consistência necessário para a solicitação.

Returns:

public DedicatedGatewayRequestOptions getDedicatedGatewayRequestOptions()

Obtém as opções de solicitação de gateway dedicado

Returns:

public List getExcludedRegions()

Obtém a lista de regiões a serem excluídas para a solicitação/repetições. Essas regiões são excluídas da lista de regiões preferenciais.

Returns:

public String getIfMatchETag()

Obtém o If-Match (ETag) associado à solicitação no serviço do Azure Cosmos DB.

Returns:

public String getIfNoneMatchETag()

Obtém a ETag (If-None-Match) associada à solicitação no serviço do Azure Cosmos DB.

Returns:

public IndexingDirective getIndexingDirective()

Obtém a diretiva de indexação (índice, não indexar etc).

Returns:

public List getPostTriggerInclude()

Obtém os gatilhos a serem invocados após a operação.

Returns:

public List getPreTriggerInclude()

Obtém os gatilhos a serem invocados antes da operação.

Returns:

public String getSessionToken()

Obtém o token para uso com consistência de sessão.

Returns:

public Duration getThresholdForDiagnosticsOnTracer()

Obtém o thresholdForDiagnosticsOnTracer, se a latência na operação CRUD for maior que essa diagnóstico será enviada para abrir o exportador de telemetria como eventos no intervalo de rastreamento da api CRUD de ponta a ponta. O padrão é 100 ms.

Returns:

public String getThroughputControlGroupName()

Obtém o nome do grupo de controle de taxa de transferência.

Returns:

public Boolean isContentResponseOnWriteEnabled()

Obtém o booliano para retornar apenas os cabeçalhos e status código na resposta do Cosmos DB no caso das operações Criar, Atualizar e Excluir no CosmosItem. Se definido como false, o serviço não retornará uma carga na resposta. Ele reduz a rede e a carga da CPU, não enviando a carga de volta pela rede e serializando-a no cliente. Esse recurso não afeta o uso de RU para operações de leitura ou gravação. OBSERVAÇÃO: esse sinalizador também está presente em CosmosClientBuilder, no entanto, se especificado em CosmosItemRequestOptions, ele substituirá o valor especificado em CosmosClientBuilder para essa solicitação. Por padrão, isso é nulo.

Returns:

public CosmosItemRequestOptions setConsistencyLevel(ConsistencyLevel consistencyLevel)

Define o nível de consistência necessário para a solicitação. O nível de consistência efetivo só pode ser reduzido para solicitações de leitura/consulta. Portanto, quando o nível de consistência padrão da Conta é, por exemplo, Sessão, você pode especificar em um nível de solicitação por solicitação para solicitações individuais que a consistência eventual é suficiente , o que poderia reduzir a latência e os encargos de RU para essa solicitação, mas não garantirá mais a consistência da sessão (leitura-sua-própria gravação) OBSERVAÇÃO: se o nível de consistência definido em um nível de solicitação aqui for SESSION e o nível de consistência padrão especificado ao construir a instância do CosmosClient por meio de CosmosClientBuilder.consistencyLevel não é SESSION, então a captura de token de sessão também precisa ser habilitada chamando CosmosClientBuilder:sessionCapturingOverrideEnabled(true) explicitamente.

Parameters:

Returns:

public CosmosItemRequestOptions setContentResponseOnWriteEnabled(Boolean contentResponseOnWriteEnabled)

Define o booliano para retornar apenas os cabeçalhos e status código na resposta do Cosmos DB no caso das operações Criar, Atualizar e Excluir no CosmosItem. Se definido como false, o serviço não retornará a carga na resposta. Ele reduz a rede e a carga da CPU, não enviando a carga de volta pela rede e serializando-a no cliente. Esse recurso não afeta o uso de RU para operações de leitura ou gravação. Por padrão, isso é nulo. OBSERVAÇÃO: esse sinalizador também está presente em CosmosClientBuilder, no entanto, se especificado em CosmosItemRequestOptions, ele substituirá o valor especificado em CosmosClientBuilder para essa solicitação.

Parameters:

Returns:

public CosmosItemRequestOptions setCosmosEndToEndOperationLatencyPolicyConfig(CosmosEndToEndOperationLatencyPolicyConfig endToEndOperationLatencyPolicyConfig)

Define o CosmosEndToEndOperationLatencyPolicyConfig a ser usado para a solicitação. Se a configuração já estiver definida no cliente, isso substituirá a configuração no nível do cliente para essa solicitação

Parameters:

Returns:

public CosmosItemRequestOptions setDedicatedGatewayRequestOptions(DedicatedGatewayRequestOptions dedicatedGatewayRequestOptions)

Define as opções de solicitação de gateway dedicado

Parameters:

Returns:

public CosmosItemRequestOptions setDiagnosticsThresholds(CosmosDiagnosticsThresholds operationSpecificThresholds)

Permite substituir os limites de diagnóstico para uma operação específica.

Parameters:

Returns:

public CosmosItemRequestOptions setExcludedRegions(List excludeRegions)

Lista de regiões a serem excluídas para a solicitação/repetições. Exemplo de "Leste dos EUA" ou "Leste dos EUA, Oeste dos EUA" Essas regiões serão excluídas da lista de regiões preferenciais

Parameters:

Returns:

public CosmosItemRequestOptions setIfMatchETag(String ifMatchETag)

Define o If-Match (ETag) associado à solicitação no serviço do Azure Cosmos DB.

Parameters:

Returns:

public CosmosItemRequestOptions setIfNoneMatchETag(String ifNoneMatchETag)

Define a ETag (If-None-Match) associada à solicitação no serviço do Azure Cosmos DB.

Parameters:

Returns:

public CosmosItemRequestOptions setIndexingDirective(IndexingDirective indexingDirective)

Define a diretiva de indexação (índice, não indexar etc).

Parameters:

Returns:

public CosmosItemRequestOptions setNonIdempotentWriteRetryPolicy(boolean nonIdempotentWriteRetriesEnabled, boolean useTrackingIdPropertyForCreateAndReplace)

Habilita novas tentativas automáticas para operações de gravação mesmo quando o SDK não pode garantir que elas sejam idempotentes. Essa é uma substituição do CosmosClientBuilder#setNonIdempotentWriteRetryPolicy(boolean, boolean) comportamento de uma solicitação/operação específica. OBSERVAÇÃO: a configuração no CosmosClientBuilder determinará o comportamento padrão das operações Criar, Substituir, Upsert e Excluir. Ele pode ser substituído na base por solicitação nas opções de solicitação. Para operações de patch por padrão (a menos que sejam substituídas nas opções de solicitação), as tentativas sempre são desabilitadas por padrão. - Criar: novas tentativas podem resultar em solicitações de 409 conflitos (mais) para o aplicativo quando uma nova tentativa tenta criar um documento que a tentativa inicial criou com êxito. Ao habilitar useTrackingIdPropertyForCreateAndReplace, isso pode ser evitado para 409-Conflict causado por novas tentativas. - Substitua: as novas tentativas podem resultar em solicitações de falha de pré-condição (mais) 412 para o aplicativo quando uma operação de substituição estiver usando uma marcar (etag) pré-condição e uma nova tentativa tentar atualizar um documento que a tentativa inicial foi atualizada com êxito (fazendo com que a etag seja alterada). Ao habilitar useTrackingIdPropertyForCreateAndReplace, isso pode ser evitado para falhas de pré-condição 412 causadas por repetições. – Excluir: novas tentativas podem resultar em solicitações de 404 solicitações de 404-NotFound quando uma operação de exclusão é repetida e a tentativa inicial foi bem-sucedida. O ideal é que as repetições de gravação só sejam habilitadas quando os aplicativos puderem lidar normalmente com o 404 – Não Encontrado. - Upsert: as tentativas podem resultar na exibição de um 200 - parecendo que o documento foi atualizado quando, na verdade, o documento foi criado pela tentativa inicial - portanto, logicamente dentro da mesma operação. Isso só afetará os aplicativos que têm maiúsculas e minúsculas especiais para 201 versus 200 para operações upsert. Patch: as novas tentativas de patch podem, mas nem sempre serão idempotentes , dependendo completamente das operações de patch que estão sendo executadas e dos filtros de pré-condição que estão sendo usados. Antes de habilitar novas tentativas de gravação para patch, isso precisa ser cuidadosamente revisado e os testes – que são repetições de wht para patch só podem ser habilitados nas opções de solicitação – qualquer configuração de todo o CosmosClient será ignorada. Execução em massa/exclusão por PK/Lote Transacional/Procedimento Stroed: não há suporte para novas tentativas automáticas.

Parameters:

Returns:

public CosmosItemRequestOptions setPostTriggerInclude(List postTriggerInclude)

Define os gatilhos a serem invocados após a operação.

Parameters:

Returns:

public CosmosItemRequestOptions setPreTriggerInclude(List preTriggerInclude)

Define os gatilhos a serem invocados antes da operação.

Parameters:

Returns:

public CosmosItemRequestOptions setSessionToken(String sessionToken)

Define o token para uso com consistência de sessão.

Parameters:

Returns:

public CosmosItemRequestOptions setThresholdForDiagnosticsOnTracer(Duration thresholdForDiagnosticsOnTracer)

Define o thresholdForDiagnosticsOnTracer, se a latência na operação CRUD for maior do que essa diagnóstico será enviada para abrir o exportador de telemetria como eventos no intervalo de rastreamento da api CRUD de ponta a ponta. O padrão é 100 ms.

Parameters:

Returns:

public void setThroughputControlGroupName(String throughputControlGroupName)

Define o nome do grupo de controle de taxa de transferência.

Parameters: