Azure Cosmos DB.NET V3 SDK (Microsoft.Azure.Cosmos) para a API SQL

APLICA-SE A: SQL API

O repositório GitHub azure-cosmos-dotnet-v3 inclui as mais recentes soluções de amostra .NET para executar CRUD e outras operações comuns em recursos DB da Azure Cosmos. Se estiver familiarizado com a versão anterior do .NET SDK, poderá estar habituado à recolha e documento dos termos. Como a Azure Cosmos DB suporta vários modelos API, a versão 3.0 do .NET SDK utiliza os termos genéricos "recipiente" e "item". Os contentores podem ser uma coleção, um grafo ou uma tabela. Os itens podem ser um documento, um vértice/aresta ou uma linha e são o conteúdo dentro dos contentores. Este artigo fornece:

  • Ligações para as tarefas em cada um dos ficheiros do projeto de C# de exemplo.
  • Ligações para o conteúdo de referência da API relacionada.

Pré-requisitos

Visual Studio 2019 com o fluxo de trabalho de desenvolvimento do Azure instalado

Uma subscrição Azure ou conta de testes gratuitos da Cosmos DB

Nota

As amostras são autossuficientes, e configuradas e limpas depois de si mesmas. Cada ocorrência fatura a sua subscrição por uma hora de utilização no nível de desempenho do seu contentor.

Exemplos de base de dados

O método RunDatabaseDemo do projeto Sample DatabaseManagement mostra como fazer as seguintes tarefas. Para saber mais sobre as bases de dados da Azure Cosmos antes de executar as seguintes amostras, consulte Work with databases, containers e itens.

Tarefa Referência da API
Criar uma base de dados CosmosClient.CreateDatabaseIfNotExistsAsync
Leia uma base de dados por ID Base de dados.ReadAsync
Leia todas as bases de dados para uma conta CosmosClient.GetDatabaseQueryIterator
Eliminar uma base de dados Base de dados.DeleteAsync

Exemplos de contentor

O método RunContainerDemo do projeto Demanagement de amostra mostra como fazer as seguintes tarefas. Para saber mais sobre os recipientes Azure Cosmos antes de executar as seguintes amostras, consulte Work with databases, containers e itens.

Tarefa Referência da API
Criar um contentor Base de dados.CreateContainerIfNotExistsAsync
Criar um recipiente com política de índice personalizado Base de dados.CreateContainerIfNotExistsAsync
Alterar desempenho configurado de um recipiente Contentor.ReplaceThroughputAsync
Obtenha um recipiente por ID Contentor.ReadContainerAsync
Leia todos os recipientes numa base de dados Base de dados.GetContainerQueryIterator
Eliminar um contentor Contentor.DeleteContainerAsync

Exemplos de itens

O método RunItemsDemo do projeto ItemManagement da amostra mostra como fazer as seguintes tarefas. Para saber mais sobre os itens da Azure Cosmos antes de executar as seguintes amostras, consulte Work with databases, containers e itens.

Tarefa Referência da API
Criar um item Contentor.CreateItemAsync
Ler um item por ID contentor. ReadItemAsync
Consulta de itens contentor. GetItemQueryIterator
Substituir um item contentor. SubstituItemAsync
Aumentar um item contentor. UpsertItemAsync
Eliminar um item contentor. DeleteItemAsync
Substitua um item por verificação ETag condicional Opções de Pedidos.IfMatchEtag

Exemplos de indexação

O método RunIndexDemo do projeto IndexManagement da amostra mostra como fazer as seguintes tarefas. Para saber mais sobre a indexação em Azure Cosmos DB antes de executar as seguintes amostras, consulte as políticas de índice, os tipos de índicese os caminhos de índice.

Tarefa Referência da API
Excluir um item do índice IndexingDirective.Exclude
Use indexação preguiçosa IndexingPolicy.IndexingMode
Excluir caminhos de item especificados do índice IndexingPolicy.ExcludedPaths

Exemplos de consultas

O método RunDemoAsync do projeto de consultas de amostra mostra como fazer as seguintes tarefas utilizando a gramática de consulta SQL, o provedor LINQ com consulta, e Lambda. Para saber mais sobre a referência de consulta SQL em Azure Cosmos DB antes de executar as seguintes amostras, consulte SQL exemplos de consulta para Azure Cosmos DB.

Tarefa Referência da API
Artigos de consulta a partir de uma única partição contentor. GetItemQueryIterator
Artigos de consulta de múltiplas divisórias contentor. GetItemQueryIterator
Consulta usando uma declaração de SQL contentor. GetItemQueryIterator

Exemplos de feed de alterações

O método RunBasicChangeFeed do projeto ChangeFeed da amostra mostra como fazer as seguintes tarefas. Para saber mais sobre a mudança de feed em Azure Cosmos DB antes de executar as seguintes amostras, consulte ler Azure Cosmos DB alterar feed feed e alterar processador de feed.

Tarefa Referência da API
Funcionalidade básica de feed de alteração Container.GetChangeFeedProcessorBuilder
Leia o feed de mudança a partir de um momento específico Container.GetChangeFeedProcessorBuilder
Leia o feed de mudança desde o início ChangeFeedProcessorBuilder.WithStartTime (DateTime)
MIgrate do processador de feed de alteração para alterar feed em V3 SDK Container.GetChangeFeedProcessorBuilder

Exemplos de programação do lado do servidor

O método RunDemoAsync do projeto ServerSideScripts da amostra mostra como fazer as seguintes tarefas. Para saber mais sobre a programação do lado do servidor no Azure Cosmos DB antes de executar as seguintes amostras, consulte procedimentos armazenados, gatilhos e funções definidas pelo utilizador.

Tarefa Referência da API
Criar um procedimento armazenado Scripts.CreateStoredProcedureAsync
Executar um procedimento armazenado Scripts.ExebonitoStoredProcedureAsync
Eliminar um procedimento armazenado Scripts.DeleteStoredProcedureAsync

Passos seguintes

A tentar planear a capacidade de uma migração para a Azure Cosmos DB? Pode utilizar informações sobre o seu cluster de base de dados existente para o planeamento de capacidades.