Container Classe

Referência

Definição

Namespace:: Microsoft.Azure.Cosmos

Assembly:: Microsoft.Azure.Cosmos.Client.dll

Pacote:: Microsoft.Azure.Cosmos v3.39.0

Origem:: Container.cs

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.

Operações para ler, substituir ou excluir um contêiner ou item específico existente em um contêiner por ID. Há dois tipos diferentes de operações.

As operações de objeto em que ele serializa e desserializa o item na solicitação/resposta
A resposta de fluxo que usa um Stream que contém um objeto serializado JSON e retorna uma resposta que contém um Stream See Database para criar novos contêineres e ler/consultar todos os contêineres.

public abstract class Container

type Container = class

Public MustInherit Class Container

Herança: Object
Container

Comentários

Observação: todas essas operações fazem chamadas contra um orçamento fixo. Você deve projetar seu sistema de modo que essas chamadas sejam dimensionadas de forma sub linear com seu aplicativo. Por exemplo, não chame 'container.readAsync()' antes de cada chamada 'container.readItemAsync()' para garantir que o contêiner exista; faça isso uma vez na inicialização do aplicativo.

Construtores

Container()

Operações para ler, substituir ou excluir um contêiner ou item específico existente em um contêiner por ID. Há dois tipos diferentes de operações.

As operações de objeto em que ele serializa e desserializa o item na solicitação/resposta
A resposta de fluxo que usa um Stream que contém um objeto serializado JSON e retorna uma resposta que contém um Stream See Database para criar novos contêineres e ler/consultar todos os contêineres.

Propriedades

Conflicts	Retorna os conflitos
Database	Retorna a referência de banco de dados pai
Id	A ID do contêiner do Cosmos
Scripts	Retorna os scripts

Métodos

CreateItemAsync<T>(T, Nullable<PartitionKey>, ItemRequestOptions, CancellationToken)	Cria um item como uma operação assíncrona no serviço do Azure Cosmos.
CreateItemStreamAsync(Stream, PartitionKey, ItemRequestOptions, CancellationToken)	Cria um Item como uma operação assíncrona no serviço do Azure Cosmos.
CreateTransactionalBatch(PartitionKey)	Inicializa uma nova instância do TransactionalBatch que pode ser usada para executar operações em vários itens no contêiner com a chave de partição fornecida de maneira transacional.
DeleteContainerAsync(ContainerRequestOptions, CancellationToken)	Exclua um ContainerProperties do serviço do Azure Cosmos DB como uma operação assíncrona.
DeleteContainerStreamAsync(ContainerRequestOptions, CancellationToken)	Exclua um ContainerProperties do serviço do Azure Cosmos DB como uma operação assíncrona.
DeleteItemAsync<T>(String, PartitionKey, ItemRequestOptions, CancellationToken)	Exclua um item do serviço do Azure Cosmos como uma operação assíncrona.
DeleteItemStreamAsync(String, PartitionKey, ItemRequestOptions, CancellationToken)	Exclua um item do serviço do Azure Cosmos como uma operação assíncrona.
GetChangeFeedEstimator(String, Container)	Obtém um ChangeFeedEstimator para monitoramento de feed de alterações.
GetChangeFeedEstimatorBuilder(String, Container+ChangesEstimationHandler, Nullable<TimeSpan>)	Inicializa um ChangeFeedProcessorBuilder para monitoramento de feed de alterações.
GetChangeFeedIterator<T>(ChangeFeedStartFrom, ChangeFeedMode, ChangeFeedRequestOptions)	Esse método cria um iterador para consumir um Feed de Alterações.
GetChangeFeedProcessorBuilder(String, Container+ChangeFeedStreamHandler)	Inicializa um ChangeFeedProcessorBuilder para processamento de feed de alterações.
GetChangeFeedProcessorBuilder<T>(String, Container.ChangeFeedHandler<T>)	Inicializa um ChangeFeedProcessorBuilder para processamento de feed de alterações.
GetChangeFeedProcessorBuilder<T>(String, Container.ChangesHandler<T>)	Inicializa um ChangeFeedProcessorBuilder para processamento de feed de alterações.
GetChangeFeedProcessorBuilderWithManualCheckpoint(String, Container+ChangeFeedStreamHandlerWithManualCheckpoint)	Inicializa um ChangeFeedProcessorBuilder para processamento de feed de alterações com ponto de verificação manual.
GetChangeFeedProcessorBuilderWithManualCheckpoint<T>(String, Container.ChangeFeedHandlerWithManualCheckpoint<T>)	Inicializa um ChangeFeedProcessorBuilder para processamento de feed de alterações com ponto de verificação manual.
GetChangeFeedStreamIterator(ChangeFeedStartFrom, ChangeFeedMode, ChangeFeedRequestOptions)	Esse método cria um iterador para consumir um Feed de Alterações.
GetFeedRangesAsync(CancellationToken)	Obtém uma lista de FeedRange que pode ser usada para paralelizar operações do Feed.
GetItemLinqQueryable<T>(Boolean, String, QueryRequestOptions, CosmosLinqSerializerOptions)	Esse método cria uma consulta LINQ para itens em um contêiner em um serviço do Azure Cosmos DB. O método de extensão IQueryable ToFeedIterator() deve ser usado para execução assíncrona com FeedIterator, consulte o exemplo 2.
GetItemQueryIterator<T>(FeedRange, QueryDefinition, String, QueryRequestOptions)	Esse método cria uma consulta para itens em um contêiner em um banco de dados do Azure Cosmos usando uma instrução SQL com valores parametrizados. Ele retorna um FeedIterator. Para obter mais informações sobre como preparar instruções SQL com valores parametrizados, consulte QueryDefinition.
GetItemQueryIterator<T>(QueryDefinition, String, QueryRequestOptions)	Esse método cria uma consulta para itens em um contêiner em um banco de dados do Azure Cosmos usando uma instrução SQL com valores parametrizados. Ele retorna um FeedIterator. Para obter mais informações sobre como preparar instruções SQL com valores parametrizados, consulte QueryDefinition.
GetItemQueryIterator<T>(String, String, QueryRequestOptions)	Esse método cria uma consulta para itens em um contêiner em um banco de dados do Azure Cosmos usando uma instrução SQL. Ele retorna um FeedIterator.
GetItemQueryStreamIterator(FeedRange, QueryDefinition, String, QueryRequestOptions)	Esse método cria uma consulta para itens em um contêiner em um banco de dados do Azure Cosmos usando uma instrução SQL com valores parametrizados. Ele retorna um FeedIterator. Para obter mais informações sobre como preparar instruções SQL com valores parametrizados, consulte QueryDefinition.
GetItemQueryStreamIterator(QueryDefinition, String, QueryRequestOptions)	Esse método cria uma consulta para itens em um contêiner em um banco de dados do Azure Cosmos usando uma instrução SQL com valores parametrizados. Ele retorna um FeedIterator. Para obter mais informações sobre como preparar instruções SQL com valores parametrizados, consulte QueryDefinition.
GetItemQueryStreamIterator(String, String, QueryRequestOptions)	Esse método cria uma consulta para itens em um contêiner em um banco de dados do Azure Cosmos usando uma instrução SQL. Ele retorna um FeedIterator.
PatchItemAsync<T>(String, PartitionKey, IReadOnlyList<PatchOperation>, PatchItemRequestOptions, CancellationToken)	Patches de um item no serviço do Azure Cosmos como uma operação assíncrona.
PatchItemStreamAsync(String, PartitionKey, IReadOnlyList<PatchOperation>, PatchItemRequestOptions, CancellationToken)	Patches de um item no serviço do Azure Cosmos como uma operação assíncrona.
ReadContainerAsync(ContainerRequestOptions, CancellationToken)	Lê um ContainerProperties do serviço do Azure Cosmos como uma operação assíncrona.
ReadContainerStreamAsync(ContainerRequestOptions, CancellationToken)	Lê um ContainerProperties do serviço do Azure Cosmos como uma operação assíncrona.
ReadItemAsync<T>(String, PartitionKey, ItemRequestOptions, CancellationToken)	Lê um item do serviço do Azure Cosmos como uma operação assíncrona.
ReadItemStreamAsync(String, PartitionKey, ItemRequestOptions, CancellationToken)	Lê um item do serviço do Azure Cosmos como uma operação assíncrona.
ReadManyItemsAsync<T>(IReadOnlyList<ValueTuple<String,PartitionKey>>, ReadManyRequestOptions, CancellationToken)	Lê vários itens de um contêiner usando valores Id e PartitionKey.
ReadManyItemsStreamAsync(IReadOnlyList<ValueTuple<String,PartitionKey>>, ReadManyRequestOptions, CancellationToken)	Lê vários itens de um contêiner usando valores Id e PartitionKey.
ReadThroughputAsync(CancellationToken)	Obtém a taxa de transferência de contêiner na medição de unidades de solicitação por segundo no serviço do Azure Cosmos.
ReadThroughputAsync(RequestOptions, CancellationToken)	Obtém a taxa de transferência de contêiner na medição de unidades de solicitação por segundo no serviço do Azure Cosmos.
ReplaceContainerAsync(ContainerProperties, ContainerRequestOptions, CancellationToken)	Substitua um ContainerProperties do serviço do Azure Cosmos como uma operação assíncrona.
ReplaceContainerStreamAsync(ContainerProperties, ContainerRequestOptions, CancellationToken)	Substitua um ContainerProperties do serviço do Azure Cosmos como uma operação assíncrona.
ReplaceItemAsync<T>(T, String, Nullable<PartitionKey>, ItemRequestOptions, CancellationToken)	Substitui um item no serviço do Azure Cosmos como uma operação assíncrona.
ReplaceItemStreamAsync(Stream, String, PartitionKey, ItemRequestOptions, CancellationToken)	Substitui um item no serviço do Azure Cosmos como uma operação assíncrona.
ReplaceThroughputAsync(Int32, RequestOptions, CancellationToken)	Define a taxa de transferência provisionada para um contêiner na medição de unidades de solicitação por segundo no serviço do Azure Cosmos.
ReplaceThroughputAsync(ThroughputProperties, RequestOptions, CancellationToken)	Define a taxa de transferência provisionada para um contêiner na medição de unidades de solicitação por segundo no serviço do Azure Cosmos.
UpsertItemAsync<T>(T, Nullable<PartitionKey>, ItemRequestOptions, CancellationToken)	Aumenta um item como uma operação assíncrona no serviço do Azure Cosmos.
UpsertItemStreamAsync(Stream, PartitionKey, ItemRequestOptions, CancellationToken)	Upserts an item stream asynchronous operation in the Azure Cosmos service.

Aplica-se a

Compartilhar via