Esempi di Azure Cosmos DB.NET V3 SDK (Microsoft.Azure.Cosmos) per l'API SQL

SI APPLICA A: API SQL

Il repository di GitHub azure-cosmos-dotnet-v3 include le soluzioni di esempio più recenti di .NET per eseguire OPERAZIONI CRUD e altre operazioni comuni sulle risorse di Cosmos db di Azure. Se si ha familiarità con la versione precedente di .NET SDK, è possibile usare la raccolta di termini e il documento. Poiché Azure Cosmos DB supporta più modelli API, la versione 3.0 di .NET SDK usa i termini generici "contenitore" e "elemento". Un contenitore può essere una raccolta, un grafico o una tabella. Un elemento può essere un documento, un bordo/vertice o una riga ed è il contenuto all'interno di un contenitore. Questo articolo fornisce:

  • Collegamenti alle attività in ognuno dei file di C# di progetto.
  • Collegamenti al contenuto di riferimento all'API correlato.

Prerequisiti

Visual Studio 2019 con il flusso di lavoro di sviluppo di Azure installato

Un abbonamento ad Azure o un account di Cosmos di valutazione DB gratuito

  • Se non si ha un abbonamento ad Azure,creare un account gratuito prima di iniziare.

  • È possibile attivare i Visual Studio pergli abbonati: l'abbonamento Visual Studio offre crediti ogni mese, che è possibile usare per i servizi di Azure a pagamento.

  • È possibile provare azure Cosmos DB gratuitamente senza un abbonamento ad Azure, gratuitamente e con impegni, oppure creare un account di livello db gratuito di Azure Cosmos, con i primi 400 RU/s e 5 GB di spazio di archiviazione gratuito. È anche possibile usare l'Cosmos db di Azure Emulator con un URI di . Per informazioni sulla chiave da usare con l'emulatore, vedere Autenticazione delle richieste.

Nota

I campioni sono autonomi e configurano e puliranno dopo se stessi. Ogni occorrenza fattura l'abbonamento per un'ora di utilizzo nel livello di prestazioni del contenitore.

Esempi di database

Il metodo RunDatabaseDemo del progetto di esempio DatabaseManagement illustra come eseguire le attività seguenti. Per informazioni sui database Cosmos azure prima di eseguire gli esempi seguenti, vedere Usare database, contenitori ed elementi.

Attività Informazioni di riferimento sulle API
Creare un database CosmosClient.CreateDatabaseIfNotExistsAsync
Leggere un database in base all'ID Database.ReadAsync
Leggere tutti i database per un account CosmosClient.GetDatabaseQueryIterator
Eliminare un database Database.DeleteAsync

Esempi di contenitori

Il metodo RunContainerDemo del progetto ContainerManagement di esempio mostra come eseguire le attività seguenti. Per informazioni sui contenitori Cosmos azure prima di eseguire gli esempi seguenti, vedere Usare database, contenitori ed elementi.

Attività Informazioni di riferimento sulle API
Creare un contenitore Database.CreateContainerIfNotExistsAsync
Creare un contenitore con criteri di indice personalizzati Database.CreateContainerIfNotExistsAsync
Modificare le prestazioni configurate di un contenitore Container.ReplaceThroughputAsync
Ottenere un contenitore in base all'ID Container.ReadContainerAsync
Leggere tutti i contenitori in un database Database.GetContainerQueryIterator
Eliminare un contenitore Container.DeleteContainerAsync

Esempi di elementi

Il metodo RunItemsDemo del progetto ItemManagement di esempio illustra come eseguire le attività seguenti. Per altre informazioni sugli elementi Cosmos azure prima di eseguire gli esempi seguenti, vedere Usare database, contenitori ed elementi.

Attività Informazioni di riferimento sulle API
Creare un elemento Container.CreateItemAsync
Leggere un elemento in base all'ID contenitore. ReadItemAsync
Query per gli elementi contenitore. GetItemQueryIterator
Sostituire un elemento contenitore. ReplaceItemAsync
Upsert di un elemento contenitore. UpsertItemAsync
Eliminare un elemento contenitore. DeleteItemAsync
Sostituire un elemento con un controllo ETag condizionale RequestOptions.IfMatchEtag
Aggiornare parzialmente (patch) un elemento contenitore. PatchItemAsync

Esempi di indicizzazione

Il metodo RunIndexDemo del progetto di esempio IndexManagement illustra come eseguire le attività seguenti. Per altre informazioni sull'indicizzazione in Azure Cosmos DB prima di eseguire gli esempi seguenti, vedere Criteri di indice,tipi di indice e percorsi di indice.

Attività Informazioni di riferimento sulle API
Escludere un elemento dall'indice IndexingDirective.Exclude
Usare l'indicizzazione lazy IndexingPolicy.IndexingMode
Escludere percorsi di elementi specificati dall'indice IndexingPolicy.ExcludedPaths

Esempi di query

Il metodo RunDemoAsync del progetto query di esempio mostra come eseguire le attività seguenti usando la grammatica della query di SQL, il provider LINQ con query e Lambda. Per informazioni sul riferimento SQL query in Azure Cosmos DB prima di eseguire gli esempi seguenti, vedere esempi di query SQL per Azure Cosmos DB.

Attività Informazioni di riferimento sulle API
Eseguire query su elementi da una singola partizione contenitore. GetItemQueryIterator
Eseguire query su elementi da più partizioni contenitore. GetItemQueryIterator
Eseguire una query usando un'istruzione SQL query contenitore. GetItemQueryIterator

Esempi di feed di modifica

Il metodo RunBasicChangeFeed del progetto ChangeFeed di esempio illustra come eseguire le attività seguenti. Per informazioni sul feed di modifiche in Azure Cosmos DB prima di eseguire gli esempi seguenti, vedere Leggere il feed di modifiche di Azure Cosmos DB e Processore feed di modifica.

Attività Informazioni di riferimento sulle API
Funzionalità di base del feed di modifiche Container.GetChangeFeedProcessorBuilder
Leggere il feed di modifiche da un'ora specifica Container.GetChangeFeedProcessorBuilder
Leggere il feed delle modifiche dall'inizio ChangeFeedProcessorBuilder.WithStartTime(DateTime)
MIgrate from change feed processor to change feed in V3 SDK Container.GetChangeFeedProcessorBuilder

Esempi di programmazione lato server

Il metodo RunDemoAsync del progetto ServerSideScripts di esempio illustra come eseguire le attività seguenti. Per informazioni sulla programmazione lato server in Azure Cosmos DB prima di eseguire gli esempi seguenti, vedere Stored procedure, trigger e funzioni definite dall'utente.

Attività Informazioni di riferimento sulle API
Creare una stored procedure Scripts.CreateStoredProcedureAsync
Eseguire una stored procedure Scripts.ExecuteStoredProcedureAsync
Eliminare una stored procedure Scripts.DeleteStoredProcedureAsync

Passaggi successivi

Si sta provando a pianificare la capacità per una migrazione ad Azure Cosmos DB? È possibile usare informazioni sul cluster di database esistente per la pianificazione della capacità.

  • Se tutto quello che si sa è il numero di vcore e server nel cluster di database esistente, leggere informazioni sulla stima delle unità di richiesta con vCore o vCPUs
  • Se si conoscono le tariffe tipiche delle richieste per il carico di lavoro corrente del database, vedere Informazioni sulla stima delle unità di richiesta con Azure Cosmos pianificazione della capacità del database