.NET Core SDK di Azure Cosmos DB per API SQL: risorse e note sulla versioneAzure Cosmos DB .NET Core SDK for SQL API: Release notes and resources

Download dell'SDKSDK downloadNuGetNuGet
Documentazione sull'APIAPI documentationDocumentazione di riferimento API .NET.NET API reference documentation
EsempiSamplesEsempi di codice .NET.NET code samples
IntroduzioneGet startedIntroduzione ad Azure Cosmos DB .NET Core SDKGet started with the Azure Cosmos DB .NET Core SDK
Esercitazione sull'app WebWeb app tutorialSviluppo di applicazioni Web con Azure Cosmos DBWeb application development with Azure Cosmos DB
Framework attualmente supportatoCurrent supported framework.NET standard 1.6 e .NET Standard 1.5.NET Standard 1.6 and .NET Standard 1.5

Note sulla versioneRelease Notes

Azure Cosmos DB .NET Core SDK ha le stesse funzionalità della versione più recente di Azure Cosmos DB .NET SDK.The Azure Cosmos DB .NET Core SDK has feature parity with the latest version of the Azure Cosmos DB .NET SDK.

2.1.32.1.3

  • È stato effettuato l'aggiornamento di System.Net.Security alla versione 4.3.2.Updated System.Net.Security to 4.3.2.

2.1.22.1.2

  • Sono stati apportati miglioramenti all'analisi diagnostica.Diagnostic tracing improvements.

2.1.12.1.1

  • Aumentata la resilienza agli errori temporanei delle richieste su più aree.Added more resilience to Multi-region request transient failures.

2.1.02.1.0

  • Aggiunto il supporto per la scrittura in più aree.Added Multi-region write support.
  • Miglioramenti alle prestazioni delle query tra più partizioni con TOP e MaxBufferedItemCount.Cross partition query performance improvements with TOP and MaxBufferedItemCount.

2.0.02.0.0

  • Aggiunto il supporto dell'annullamento richiesta.Added request cancellation support.
  • Aggiunta SetCurrentLocation a ConnectionPolicy, che popola automaticamente le posizioni preferite in base alla regione.Added SetCurrentLocation to ConnectionPolicy, which automatically populates the preferred locations based on the region.
  • Correzione del bug nelle query su più partizioni con Min/Max e un filtro che mette in corrispondenza nessun documento in una singola partizione.Fixed Bug in Cross Partition Queries with Min/Max and a filter that matches no documents on an individual partition.
  • I metodi DocumentClient ora dispongono della parità con IDocumentClient.DocumentClient methods now have parity with IDocumentClient.
  • Aggiornato lo stack di trasporto TCP diretto per ridurre il numero di connessioni stabilite.Updated direct TCP transport stack to reduce the number of connections established.
  • Aggiunta del supporto per TCP in modalità diretta per i client non Windows.Added support for Direct Mode TCP for non-Windows clients.

2.0.0-preview22.0.0-preview2

  • Aggiunto il supporto dell'annullamento richiesta.Added request cancellation support.
  • Aggiunta SetCurrentLocation a ConnectionPolicy, che popola automaticamente le posizioni preferite in base alla regione.Added SetCurrentLocation to ConnectionPolicy, which automatically populates the preferred locations based on the region.
  • Correzione del bug nelle query su più partizioni con Min/Max e un filtro che mette in corrispondenza nessun documento in una singola partizione.Fixed Bug in Cross Partition Queries with Min/Max and a filter that matches no documents on an individual partition.

2.0.0-preview2.0.0-preview

  • I metodi DocumentClient ora dispongono della parità con IDocumentClient.DocumentClient methods now have parity with IDocumentClient.
  • Aggiornato lo stack di trasporto TCP diretto per ridurre il numero di connessioni stabilite.Updated direct TCP transport stack to reduce the number of connections established.
  • Aggiunta del supporto per TCP in modalità diretta per i client non Windows.Added support for Direct Mode TCP for non-Windows clients.

1.10.01.10.0

  • Aggiunta della proprietà ConsistencyLevel a FeedOptions.Added ConsistencyLevel Property to FeedOptions.
  • Aggiunta di JsonSerializerSettings a RequestOptions e FeedOptions.Added JsonSerializerSettings to RequestOptions and FeedOptions.
  • Aggiunta di EnableReadRequestsFallback a ConnectionPolicy.Added EnableReadRequestsFallback to ConnectionPolicy.

1.9.11.9.1

  • È stato risolto il problema della visualizzazione di un'eccezione KeyNotFoundException per le query ORDER BY su più partizioni in casi limite.Fixed KeyNotFoundException for cross partition order by queries in corner cases.
  • Correzione del bug per cui l'attributo JsonPropery nella clausola SELECT per le query LINQ non viene rispettato.Fixed bug where JsonPropery attribute in select clause for LINQ queries was not being honored.

1.8.21.8.2

  • Correzione del bug che si verifica in determinate race condition, che comporta errori intermittenti "Microsoft.Azure.Documents.NotFoundException: The read session is not available for the input session token" (La sessione di lettura non è disponibile per il token della sessione di input) quando si usa il livello di coerenza di sessione.Fixed bug that is hit under certain race conditions, that results in intermittent "Microsoft.Azure.Documents.NotFoundException: The read session is not available for the input session token" errors when using Session consistency level.

1.8.11.8.1

  • Correzione della regressione in cui FeedOptions.MaxItemCount = -1 ha generato un errore System.ArithmeticException: dimensioni pagina negative.Fixed regression where FeedOptions.MaxItemCount = -1 threw an System.ArithmeticException: page size is negative.
  • Aggiunta di una nuova funzione ToString() a QueryMetrics.Added a new ToString() function to QueryMetrics.
  • Esposizione delle statistiche della partizione nelle raccolte di lettura.Exposed partition statistics on reading collections.
  • Aggiunta della proprietà PartitionKey a ChangeFeedOptions.Added PartitionKey property to ChangeFeedOptions.
  • Correzione di bug di minore entità.Minor bug fixes.

1.7.11.7.1

  • Aggiunge la possibilità di specificare gli indici univoci per i documenti usando proprietà UniqueKeyPolicy in DocumentCollection.Adds the ability to specify unique indexes for the documents by using UniqueKeyPolicy property on the DocumentCollection.
  • È stato corretto un bug in cui le impostazioni JsonSerializer personalizzate non vengono rispettate per l'esecuzione di alcune query e stored procedure.Fixed a bug in which the custom JsonSerializer settings were not being honored for some queries and stored procedure execution.

1.7.01.7.0

  • Modifica della personalizzazione da Azure DocumentDB ad Azure Cosmos DB nella documentazione di riferimento delle API, nelle informazioni sui metadati negli assembly e nel pacchetto NuGet.Branding change from Azure DocumentDB to Azure Cosmos DB in the API Reference documentation, metadata information in assemblies, and the NuGet package.
  • Esposizione delle informazioni di diagnostica e della latenza della risposta alle richieste inviate con la modalità di connettività diretta.Expose diagnostic information and latency from the response of requests sent with direct connectivity mode. I nomi delle proprietà sono RequestDiagnosticsString e RequestLatency per la classe ResourceResponse.The property names are RequestDiagnosticsString and RequestLatency on ResourceResponse class.
  • Questa versione dell'SDK richiede la versione più recente dell'emulatore di Azure Cosmos DB che è possibile scaricare dalla pagina https://aka.ms/cosmosdb-emulator.This SDK version requires the latest version of Azure Cosmos DB Emulator available for download from https://aka.ms/cosmosdb-emulator.

1.6.01.6.0

  • Aggiunta di diverse correzioni e miglioramenti dell'affidabilità.Added several reliability fixes and improvements.

1.5.11.5.1

1.5.01.5.0

  • Aggiunta del supporto per PartitionKeyRangeId come FeedOption per limitare l'ambito dei risultati di query a un intervallo di chiavi di partizione specifico.Added support for PartitionKeyRangeId as a FeedOption for scoping query results to a specific partition key range value.
  • Aggiunta del supporto per StartTime come ChangeFeedOption per avviare la ricerca delle modifiche a partire dall'ora di inizio.Added support for StartTime as a ChangeFeedOption to start looking for the changes after that time.

1.4.11.4.1

  • È stato risolto un problema nella classe JsonSerializable che può generare un'eccezione di overflow dello stack.Fixed an issue in the JsonSerializable class that may cause a stack overflow exception.

1.4.01.4.0

  • Aggiunta del supporto per la definizione di JsonSerializerSettings personalizzate durante la creazione di un'istanza di DocumentClient.Added support for specifying custom JsonSerializerSettings while instantiating a DocumentClient instance.

1.3.21.3.2

  • Supporto di .NET Standard 1.5 come uno dei framework di destinazione.Supporting .NET Standard 1.5 as one of the target frameworks.

1.3.11.3.1

  • Risoluzione di un problema riguardante i computer x64 che non supportano l'istruzione SSE4 e generano SEHException durante l'esecuzione di query di Azure Cosmos DB.Fixed an issue that affected x64 machines that don’t support SSE4 instruction and throw SEHException when running Azure Cosmos DB queries.

1.3.01.3.0

  • Aggiunta del supporto per un nuovo livello di coerenza denominato ConsistentPrefix.Added support for a new consistency level called ConsistentPrefix.
  • Aggiunta del supporto per le metriche delle query per le singole partizioni.Added support for query metrics for individual partitions.
  • Aggiunta del supporto per la limitazione delle dimensioni del token di continuazione per le query.Added support for limiting the size of the continuation token for queries.
  • Aggiunta del supporto per una traccia più dettagliata delle richieste non riuscite.Added support for more detailed tracing for failed requests.
  • Alcuni miglioramenti delle prestazioni nell'SDK.Made some performance improvements in the SDK.

1.2.21.2.2

  • Risolto un problema per cui il valore PartitionKey in FeedOptions veniva ignorato per le query di aggregazione.Fixed an issue that ignored the PartitionKey value provided in FeedOptions for aggregate queries.
  • Risolto un problema nella gestione trasparente delle partizioni durante l'esecuzione dell'ordinamento per query della partizione trasversale intermedia.Fixed an issue in transparent handling of partition management during mid-flight cross-partition Order By query execution.

1.2.11.2.1

  • Correzione di un problema che ha causato deadlock in alcune API asincrone, se usate in un contesto ASP.NET.Fixed an issue which caused deadlocks in some of the async APIs when used inside ASP.NET context.

1.2.01.2.0

  • Correzioni per rendere l'SDK più resiliente per il failover automatico in determinate condizioni.Fixes to make SDK more resilient to automatic failover under certain conditions.

1.1.21.1.2

  • Correzione di un problema che occasionalmente causa un'eccezione WebException, ovvero l'impossibilità di risolvere il nome remoto.Fix for an issue that occasionally causes a WebException: The remote name could not be resolved.
  • Aggiunta del supporto per la lettura diretta di un documento con tipo includendo nuovi overload all'API ReadDocumentAsync.Added the support for directly reading a typed document by adding new overloads to ReadDocumentAsync API.

1.1.11.1.1

  • Aggiunta del supporto LINQ per le query di aggregazione (COUNT, MIN, MAX, SUM e AVG).Added LINQ support for aggregation queries (COUNT, MIN, MAX, SUM, and AVG).
  • Correzione per un problema di perdita di memoria per l'oggetto ConnectionPolicy provocata dall'uso del gestore eventi.Fix for a memory leak issue for the ConnectionPolicy object caused by the use of event handler.
  • Correzione per un problema relativo al mancato funzionamento di UpsertAttachmentAsync in caso di uso di ETag.Fix for an issue wherein UpsertAttachmentAsync was not working when ETag was used.
  • Correzione di un problema relativo al mancato funzionamento della continuazione della query di tipo order-by tra partizioni in caso di ordinamento in un campo di tipo stringa.Fix for an issue wherein cross partition order-by query continuation was not working when sorting on string field.

1.1.01.1.0

  • Aggiunta del supporto per le query di aggregazione (COUNT, MIN, MAX, SUM e AVG).Added support for aggregation queries (COUNT, MIN, MAX, SUM, and AVG). Vedere Supporto dell'aggregazione.See Aggregation support.
  • Velocità effettiva minima ridotta nelle raccolte partizionate da 10.100 UR/s a 2.500 UR/s.Lowered minimum throughput on partitioned collections from 10,100 RU/s to 2500 RU/s.

1.0.01.0.0

Azure Cosmos DB .NET Core SDK consente di compilare app ASP.NET Core e .NET Core veloci e multipiattaforma da eseguire in Windows, Mac e Linux.The Azure Cosmos DB .NET Core SDK enables you to build fast, cross-platform ASP.NET Core and .NET Core apps to run on Windows, Mac, and Linux. L'ultima versione di Azure Cosmos DB .NET Core SDK è completamente compatibile con Xamarin e può essere usata per compilare applicazioni destinate a iOS, Android e Mono (Linux).The latest release of the Azure Cosmos DB .NET Core SDK is fully Xamarin compatible and be used to build applications that target iOS, Android, and Mono (Linux).

0.1.0-preview0.1.0-preview

Azure Cosmos DB .NET Core Preview SDK consente di compilare app ASP.NET Core e .NET Core veloci e multipiattaforma da eseguire in Windows, Mac e Linux.The Azure Cosmos DB .NET Core Preview SDK enables you to build fast, cross-platform ASP.NET Core and .NET Core apps to run on Windows, Mac, and Linux.

Azure Cosmos DB .NET Core Preview SDK ha le stesse funzionalità della versione più recente di Azure Cosmos DB .NET SDK e supporta quanto segue.The Azure Cosmos DB .NET Core Preview SDK has feature parity with the latest version of the Azure Cosmos DB .NET SDK and supports the following:

Per domande su questo SDK, pubblicare un post su StackOverflow o inserire la domanda nel repository github.If you have questions related to this SDK, post to StackOverflow, or file an issue in the github repository.

Date di rilascio e di ritiroRelease & Retirement Dates

VersionVersion Data di rilascioRelease Date Data di ritiroRetirement Date
2.1.32.1.3 15 ottobre 2018October 15, 2018 ---
2.1.22.1.2 4 ottobre 2018October 04, 2018 ---
2.1.12.1.1 27 settembre 2018September 27, 2018 ---
2.1.02.1.0 21 settembre 2018September 21, 2018 ---
2.0.02.0.0 7 settembre 2018September 07, 2018 ---
1.9.11.9.1 09 marzo 2018March 09, 2018 ---
1.8.21.8.2 21 febbraio 2018February 21, 2018 ---
1.8.11.8.1 05 febbraio 2018February 05, 2018 ---
1.7.11.7.1 16 novembre 2017November 16, 2017 ---
1.7.01.7.0 10 novembre 2017November 10, 2017 ---
1.6.01.6.0 17 ottobre 2017October 17, 2017 ---
1.5.11.5.1 02 ottobre 2017October 02, 2017 ---
1.5.01.5.0 10 agosto 2017August 10, 2017 ---
1.4.11.4.1 07 agosto 2017August 07, 2017 ---
1.4.01.4.0 02 agosto 2017August 02, 2017 ---
1.3.21.3.2 12 giugno 2017June 12, 2017 ---
1.3.11.3.1 23 maggio 2017May 23, 2017 ---
1.3.01.3.0 10 maggio 2017May 10, 2017 ---
1.2.21.2.2 19 aprile 2017April 19, 2017 ---
1.2.11.2.1 29 marzo 2017March 29, 2017 ---
1.2.01.2.0 25 marzo 2017March 25, 2017 ---
1.1.21.1.2 20 marzo 2017March 20, 2017 ---
1.1.11.1.1 14 marzo 2017March 14, 2017 ---
1.1.01.1.0 16 febbraio 2017February 16, 2017 ---
1.0.01.0.0 21 dicembre 2016December 21, 2016 ---
0.1.0-preview0.1.0-preview 15 novembre 2016November 15, 2016 31 dicembre 2016December 31, 2016

Vedere ancheSee Also

Per altre informazioni su Cosmos DB, vedere la pagina del servizio Microsoft Azure Cosmos DB.To learn more about Cosmos DB, see Microsoft Azure Cosmos DB service page.