Domande frequenti su Azure Cosmos DBAzure Cosmos DB FAQ

Nozioni fondamentali su Azure Cosmos DBAzure Cosmos DB fundamentals

Che cos'è Azure Cosmos DB?What is Azure Cosmos DB?

Azure Cosmos DB è un servizio di database multimodello con replica globale che offre avanzate funzionalità di query sui dati privi di schema e consente di ottenere prestazioni configurabili e affidabili e un rapido sviluppo.Azure Cosmos DB is a globally replicated, multi-model database service that that offers rich querying over schema-free data, helps deliver configurable and reliable performance, and enables rapid development. Tutti questi vantaggi sono garantiti da una piattaforma gestita supportata dalla potenza e dalla copertura di Microsoft Azure.It's all achieved through a managed platform that's backed by the power and reach of Microsoft Azure.

Azure Cosmos DB è la soluzione ideale per applicazioni Web, per dispositivi mobili, di gioco e IoT in cui velocità effettiva prevedibile, disponibilità elevata, bassa latenza e un modello di dati privo di schema sono requisiti chiave.Azure Cosmos DB is the right solution for web, mobile, gaming, and IoT applications when predictable throughput, high availability, low latency, and a schema-free data model are key requirements. Offre flessibilità dello schema e indicizzazione avanzata e include il supporto di transazioni su più documenti con JavaScript integrato.It delivers schema flexibility and rich indexing, and it includes multi-document transactional support with integrated JavaScript.

Per altre domande sui database, risposte e istruzioni per la distribuzione e l'uso di questo servizio, vedere la [pagina della documentazione di Azure Cosmos DB]((https://docs.microsoft.com/azure/cosmos-db/).For more database questions, answers, and instructions for deploying and using this service, see the [Azure Cosmos DB documentation page]((https://docs.microsoft.com/azure/cosmos-db/).

Che cosa è successo a DocumentDB?What happened to DocumentDB?

L'API DocumentDB è una delle API e uno dei modelli di dati supportati per Azure Cosmos DB.The DocumentDB API is one of the supported APIs and data models for Azure Cosmos DB. Azure Cosmos DB supporta l'utente anche con l'API Graph (anteprima), l'API Tabelle e l'API MongoDB.In addition, Azure Cosmos DB supports you with Graph API (Preview), Table API and MongoDB API. Per altre informazioni, vedere Domande di clienti di DocumentDB.For more information, see Questions from DocumentDB customers.

Come si accede al proprio account DocumentDB nel portale di Azure?How do I get to my DocumentDB account in the Azure portal?

Nel portale di Azure fare clic sull'icona di Azure Cosmos DB nel riquadro sinistro.In the Azure portal, click the Azure Cosmos DB icon in the left pane. Se in precedenza si aveva un account DocumentDB, adesso si ha un account Azure Cosmos DB senza alcun cambiamento nella fatturazione.If you had a DocumentDB account before, you now have an Azure Cosmos DB account, with no change to your billing.

Quali sono i casi d'uso tipici per Azure Cosmos DB?What are the typical use cases for Azure Cosmos DB?

Azure Cosmos DB è la scelta ideale per le nuove applicazioni Web, per dispositivi mobili, di gioco e IoT in cui scalabilità automatica, prestazioni prevedibili, tempi di risposta rapidi nell'ordine di millisecondi e la possibilità di eseguire query su dati privi di schema sono importanti.Azure Cosmos DB is a good choice for new web, mobile, gaming, and IoT applications where automatic scale, predictable performance, fast order of millisecond response times, and the ability to query over schema-free data is important. Azure Cosmos DB si presta allo sviluppo rapido e al supporto dell'iterazione continua dei modelli di dati delle applicazioni.Azure Cosmos DB lends itself to rapid development and supporting the continuous iteration of application data models. Le applicazioni che gestiscono contenuto e dati generati dall'utente rappresentano casi d'uso comuni di Azure Cosmos DB.Applications that manage user-generated content and data are common use cases for Azure Cosmos DB.

Come vengono offerte prestazioni prevedibili in Azure Cosmos DB?How does Azure Cosmos DB offer predictable performance?

Un'unità richiesta (UR) è l'unità di misura della velocità effettiva in Azure Cosmos DB.A request unit (RU) is the measure of throughput in Azure Cosmos DB. Una velocità effettiva di 1 UR corrisponde alla velocità effettiva dell'operazione GET su un documento da 1 KB.A 1-RU throughput corresponds to the throughput of the GET of a 1-KB document. Ogni operazione in Azure Cosmos DB, incluse letture, scritture, query SQL ed esecuzioni di stored procedure, ha un valore di UR deterministico basato sulla velocità effettiva necessaria per completare l'operazione.Every operation in Azure Cosmos DB, including reads, writes, SQL queries, and stored procedure executions, has a deterministic RU value that's based on the throughput required to complete the operation. Invece di considerare CPU, I/O e memoria e il modo in cui ognuno di essi influisce sulla velocità effettiva dell'applicazione, è possibile ragionare in termini di singola misura di UR.Instead of thinking about CPU, IO, and memory and how they each affect your application throughput, you can think in terms of a single RU measure.

Ogni contenitore di Azure Cosmos DB può essere riservato con la velocità effettiva di provisioning in termini di UR di velocità effettiva al secondo.You can reserve each Azure Cosmos DB container with provisioned throughput in terms of RUs of throughput per second. Per applicazioni di qualsiasi dimensione, è possibile effettuare un benchmark delle singole richieste per misurarne i valori di UR ed effettuare il provisioning di un contenitore per gestire il totale delle unità richiesta tra tutte le richieste.For applications of any scale, you can benchmark individual requests to measure their RU values, and provision a container to handle the total of request units across all requests. È anche possibile aumentare o ridurre la velocità effettiva del contenitore con il variare delle esigenze dell'applicazione.You can also scale up or scale down your container's throughput as the needs of your application evolve. Per altre informazioni sulle unità richiesta e su come determinare le esigenze a livello di contenitore, vedere Stima delle esigenze di velocità effettiva e provare il calcolatore della velocità effettiva.For more information about request units and for help determining your container needs, see Estimating throughput needs and try the throughput calculator. Il termine contenitore fa qui riferimento a una raccolta dell'API DocumentDB, un grafo dell'API Graph, una raccolta dell'API MongoDB e una tabella dell'API Table.The term container here refers to refers to a DocumentDB API collection, Graph API graph, MongoDB API collection, and Table API table.

In che modo Azure Cosmos DB supporta diversi modelli di dati, ad esempio chiave/valore, colonne, documenti e grafi?How does Azure Cosmos DB support various data models such as key/value, columnar, document and graph?

I modelli di dati chiave/valore (tabella), colonne, documenti e grafi sono tutti supportati a livello nativo grazie alla progettazione ARS (atom, record e sequenze) su cui si basa Azure Cosmos DB.Key/value (table), columnar, document and graph data models are all natively supported because of the ARS (atoms, records and sequences) design that Azure Cosmos DB is built on. È facilmente possibile eseguire il mapping e la proiezione di atom, record e sequenze in diversi modelli di dati.Atoms, records, and sequences can be easily mapped and projected to various data models. Le API per un subset di modelli sono già disponibili (API DocumentDB, MongoDB, Table e Graph) e altre, specifiche di modelli di dati aggiuntivi, saranno disponibili in futuro.The APIs for a subset of models are available right now (DocumentDB, MongoDB, Table, and Graph APIs) and others specific to additional data models will be available in the future.

Azure Cosmos DB ha un motore di indicizzazione indipendente dallo schema che può indicizzare automaticamente tutti i dati inseriti senza richiedere schemi o indici secondari agli sviluppatori.Azure Cosmos DB has a schema agnostic indexing engine capable of automatically indexing all the data it ingests without requiring any schema or secondary indexes from the developer. Il motore si basa su un set di layout di indice logici (invertiti, colonne, albero) che separano il layout di archiviazione dai sottosistemi di elaborazione di indici e query.The engine relies on a set of logical index layouts (inverted, columnar, tree) which decouple the storage layout from the index and query processing subsystems. Cosmos DB riesce anche a supportare un set di API e protocolli di trasmissione in modalità estendibile e a convertirli nel modello di dati principale (1) e nei layout di indice logici (2), supportando in modo esclusivo più modelli di dati a livello nativo.Cosmos DB also has the ability to support a set of wire protocols and APIs in an extensible manner and translate them efficiently to the core data model (1) and the logical index layouts (2) making it uniquely capable of supporting multiple data models natively.

Azure Cosmos DB è conforme alla normativa HIPAA?Is Azure Cosmos DB HIPAA compliant?

Sì, Azure Cosmos DB è conforme alla normativa HIPAA.Yes, Azure Cosmos DB is HIPAA-compliant. La normativa HIPAA stabilisce i requisiti per l'uso, la divulgazione e la protezione delle informazioni sanitarie personali sensibili.HIPAA establishes requirements for the use, disclosure, and safeguarding of individually identifiable health information. Per altre informazioni, visitare il Centro protezione Microsoft.For more information, see the Microsoft Trust Center.

Quali sono i limiti di archiviazione di Azure Cosmos DB?What are the storage limits of Azure Cosmos DB?

In Azure Cosmos DB non esiste alcun limite alla quantità totale di dati che può essere archiviata in un contenitore.There is no limit to the total amount of data that a container can store in Azure Cosmos DB.

Quali sono i limiti di velocità effettiva di Azure Cosmos DB?What are the throughput limits of Azure Cosmos DB?

In Azure Cosmos DB non esiste alcun limite alla velocità effettiva totale che può essere supportata da un contenitore.There is no limit to the total amount of throughput that a container can support in Azure Cosmos DB. Lo scopo primario è distribuire il carico di lavoro in modo abbastanza uniforme tra un numero sufficientemente elevato di chiavi di partizione.The key idea is to distribute your workload roughly evenly among a sufficiently large number of partition keys.

Quanto costa Azure Cosmos DB?How much does Azure Cosmos DB cost?

Per informazioni dettagliate, vedere la pagina Prezzi di Azure Cosmos DB.For details, refer to the Azure Cosmos DB pricing details page. Gli addebiti per l'utilizzo di Azure Cosmos DB sono determinati dal numero di contenitori sottoposti a provisioning, dal numero di ore in cui i contenitori sono stati online e dalla velocità effettiva di provisioning per ogni contenitore.Azure Cosmos DB usage charges are determined by the number of provisioned containers, the number of hours the containers were online, and the provisioned throughput for each container. Il termine contenitori fa qui riferimento a raccolte dell'API DocumentDB, grafi dell'API Graph, raccolte dell'API MongoDB e tabelle dell'API Table.The term containers here refers to the DocumentDB API collection, Graph API graph, MongoDB API collection, and Table API tables.

È disponibile un account gratuito?Is a free account available?

Sì, è possibile ottenere un account gratuito per un tempo limitato, senza alcun impegno.Yes, you can sign up for a time-limited account at no charge, with no commitment. Per iscriversi, visitare la pagina Prova gratuitamente Azure Cosmos DB. Per altre informazioni, vedere Domande frequenti su Azure Cosmos DB.To sign up, visit Try Azure Cosmos DB for free or read more in the Try Azure Cosmos DB FAQ.

I nuovi utenti possono iscriversi per ottenere un account gratuito di Azureche è valido 30 giorni e include un credito per provare tutti i servizi di Azure.If you are new to Azure, you can sign up for an Azure free account, which gives you 30 days and and a credit to try all the Azure services. Se si ha una sottoscrizione di Visual Studio, si ha anche diritto a crediti Azure gratuiti da usare per qualsiasi servizio di Azure.If you have a Visual Studio subscription, you are also eligible for free Azure credits to use on any Azure service.

È anche possibile usare l'emulatore di Azure Cosmos DB per sviluppare e testare gratuitamente l'applicazione in locale, senza creare una sottoscrizione di Azure.You can also use the Azure Cosmos DB Emulator to develop and test your application locally for free, without creating an Azure subscription. Quando si è soddisfatti del funzionamento dell'applicazione nell'emulatore di Azure Cosmos DB, è possibile iniziare a usare l'account Azure Cosmos DB nel cloud.When you're satisfied with how your application is working in the Azure Cosmos DB Emulator, you can switch to using an Azure Cosmos DB account in the cloud.

Come è possibile ottenere informazioni e supporto aggiuntivi per Azure Cosmos DB?How can I get additional help with Azure Cosmos DB?

Per ottenere informazioni o supporto, visitare il sito Stack Overflow o il forum MSDN oppure programmare una chat diretta con il team di progettazione di Azure Cosmos DB inviando un messaggio di posta elettronica all'indirizzo askcosmosdb@microsoft.com.If you need any help, reach out to us on Stack Overflow or the MSDN forum, or schedule a one-on-one chat with the Azure Cosmos DB engineering team by sending mail to askcosmosdb@microsoft.com.

Provare gratuitamente Azure Cosmos DBTry Azure Cosmos DB subscriptions

È ora possibile provare Azure Cosmos DB per un tempo limitato senza alcuna sottoscrizione, gratuitamente e senza impegno.You can now enjoy a time-limited Azure Cosmos DB experience without a subscription, free of charge and commitments. Per registrarsi a una sottoscrizione di prova di Azure Cosmos DB, andare alla pagina Prova gratuitamente Azure DB Cosmos.To sign up for a Try Azure Cosmos DB subscription, go to Try Azure Cosmos DB for free. Questa sottoscrizione differisce dalla versione di valutazione gratuita di Azure e può essere usata in aggiunta alla versione di valutazione gratuita di Azure o a una sottoscrizione a pagamento di Azure.This subscription is separate from the Azure Free Trial, and can be used in addition to an Azure Free Trial or an Azure paid subscription.

Le sottoscrizioni di prova di Azure Cosmos DB vengono visualizzate nel portale di Azure accanto alle altre sottoscrizioni associate al proprio ID utente.Try Azure Cosmos DB subscriptions appear in the Azure portal next other subscriptions associated with your user ID.

Le condizioni seguenti si applicano alle sottoscrizioni di prova di Azure Cosmos DB:The following conditions apply to Try Azure Cosmos DB subscriptions:

  • Un contenitore per sottoscrizione per account SQL (API DocumentDB), Gremlin (API Graph) e Tabella.One container per subscription for SQL (DocumentDB API), Gremlin (Graph API), and Table accounts.
  • Fino a 3 raccolte per sottoscrizione per gli account MongoDB.Up to 3 collections per subscription for MongoDB accounts.
  • 10 GB di capacità di archiviazione.10 GB storage capacity.
  • La replica globale è disponibile nelle seguenti aree di Azure: Stati Uniti centrali, Europa settentrionale e Asia sudorientaleGlobal replication is available in the following Azure regions: Central US, North Europe and Southeast Asia
  • Velocità effettiva massima di 5.000 UR/sec.Maximum throughput of 5K RU/s.
  • Le sottoscrizioni scadono dopo 24 ore e possono essere estese fino a un massimo di 48 ore totali.Subscriptions expire after 24 hours, and can be extended to a maximum of 48 hours total.
  • Non è possibile creare ticket di supporto di Azure per gli account di prova di Azure Cosmos DB. È tuttavia previsto il supporto per i sottoscrittori con piani di supporto attivi.Azure support tickets cannot be created for Try Azure Cosmos DB accounts; however, support is provided for subscribers with existing support plans.

Configurazione di Azure Cosmos DBSet up Azure Cosmos DB

Come ci si iscrive ad Azure Cosmos DB?How do I sign up for Azure Cosmos DB?

Azure Cosmos DB è disponibile nel portale di Azure.Azure Cosmos DB is available in the Azure portal. Per prima cosa, iscriversi per ottenere una sottoscrizione di Azure.First, sign up for an Azure subscription. Dopo aver effettuato l'iscrizione, è possibile aggiungere un account API DocumentDB, API Graph (anteprima), API Tabelle o API MongoDB alla sottoscrizione di Azure.After you've signed up, you can add a DocumentDB API, Graph API (Preview), Table API, or MongoDB API account to your Azure subscription.

Che cos'è una chiave master?What is a master key?

Una chiave master è un token di sicurezza per l'accesso a tutte le risorse di un account.A master key is a security token to access all resources for an account. Gli utenti con la chiave hanno accesso in lettura e scrittura a tutte le risorse nell'account del database.Individuals with the key have read and write access to all resources in the database account. Distribuire le chiavi master con cautela.Use caution when you distribute master keys. La chiave master primaria e la chiave master secondaria sono disponibili nel pannello Chiavi del portale di Azure.The primary master key and secondary master key are available on the Keys blade of the Azure portal. Per altre informazioni sulle chiavi, vedere Visualizzare, copiare e rigenerare le chiavi di accesso.For more information about keys, see View, copy, and regenerate access keys.

Su quali aree è possibile impostare PreferredLocations?What are the regions that PreferredLocations can be set to?

Il valore di PreferredLocations può essere impostato su qualsiasi area di Azure in cui è disponibile Cosmos DB.The PreferredLocations value can be set to any of the Azure regions in which Cosmos DB is available. Per un elenco delle aree disponibili, vedere Aree di Azure.For a list of available regions, see Azure regions.

Di quali aspetti è consigliabile tenere conto quando si distribuiscono dati nel mondo tramite i data center di Azure?Is there anything I should be aware of when distributing data across the world via the Azure datacenters?

Azure Cosmos DB è presente in tutte le aree di Azure, come specificato nella pagina Aree di Azure.Azure Cosmos DB is present across all Azure regions, as specified on the Azure regions page. Dato che si tratta del servizio di base, in ogni nuovo data center è disponibile Azure Cosmos DB.Because it is the core service, every new datacenter has an Azure Cosmos DB presence.

Quando si imposta un'area, tenere presente che Azure Cosmos DB rispetta i cloud sovrani e per enti pubblici.When you set a region, remember that Azure Cosmos DB respects sovereign and government clouds. Di conseguenza, se si crea un account in un'area sovrana non è possibile eseguire la replica all'esterno di tale area.That is, if you create an account in a sovereign region, you cannot replicate out of that sovereign region. Analogamente, non è possibile abilitare la replica in altre località sovrane da un account esterno.Similarly, you cannot enable replication into other sovereign locations from an outside account.

Sviluppo con l'API DocumentDBDevelop against the DocumentDB API

Come si inizia a eseguire lo sviluppo con l'API DocumentDB?How do I start developing against the DocumentDB API?

L'API Microsoft DocumentDB è disponibile nel portale di Azure.Microsoft DocumentDB API is available in the Azure portal. Per prima cosa, è necessario iscriversi per ottenere una sottoscrizione di Azure.First you must sign up for an Azure subscription. Dopo aver ottenuto una sottoscrizione di Azure, è possibile aggiungere un contenitore dell'API DocumentDB alla sottoscrizione di Azure.Once you sign up for an Azure subscription, you can add DocumentDB API container to your Azure subscription. Per istruzioni sull'aggiunta di un account Azure Cosmos DB, vedere Creare un account di database.For instructions on adding an Azure Cosmos DB account, see Create an Azure Cosmos DB database account. Se in passato si aveva un account DocumentDB, adesso si ha un account Azure Cosmos DB.If you had a DocumentDB account in the past, you now have an Azure Cosmos DB account.

SDK per .NET, Python, Node.js, JavaScript e Java.SDKs are available for .NET, Python, Node.js, JavaScript, and Java. Gli sviluppatori possono anche usare le API HTTP RESTful per interagire con le risorse di Azure Cosmos DB da un'ampia gamma di piattaforme e linguaggi.Developers can also use the RESTful HTTP APIs to interact with Azure Cosmos DB resources from various platforms and languages.

È possibile accedere a esempi già pronti per iniziare rapidamente?Can I access some ready-made samples to get a head start?

In GitHub sono disponibili esempi per gli SDK .NET, Java, Node.js e Python per l'API DocumentDB.Samples for the DocumentDB API .NET, Java, Node.js, and Python SDKs are available on GitHub.

Il database dell'API DocumentDB supporta dati privi di schema?Does the DocumentDB API database support schema-free data?

Sì. L'API DocumentDB consente alle applicazioni di archiviare documenti JSON arbitrari senza hint o definizioni dello schema.Yes, the DocumentDB API allows applications to store arbitrary JSON documents without schema definitions or hints. I dati sono immediatamente disponibili per l'esecuzione di query tramite l'interfaccia di query SQL di Azure Cosmos DB.Data is immediately available for query through the Azure Cosmos DB SQL query interface.

L'API DocumentDB supporta le transazioni ACID?Does the DocumentDB API support ACID transactions?

Sì. L'API DocumentDB supporta le transazioni tra documenti espresse come trigger e stored procedure JavaScript.Yes, the DocumentDB API supports cross-document transactions expressed as JavaScript-stored procedures and triggers. L'ambito delle transazioni è limitato a una singola partizione in ogni raccolta e le transazioni vengono eseguite con semantica ACID in modalità "tutto o niente", isolate da altro codice e altre richieste utente in esecuzione contemporaneamente.Transactions are scoped to a single partition within each collection and executed with ACID semantics as "all or nothing," isolated from other concurrently executing code and user requests. Se vengono generate eccezioni tramite l'esecuzione sul lato server del codice dell'applicazione JavaScript, viene eseguito il rollback dell'intera transazione.If exceptions are thrown through the server-side execution of JavaScript application code, the entire transaction is rolled back. Per altre informazioni sulle transazioni, vedere Transazioni del programma del database.For more information about transactions, see Database program transactions.

Che cos'è una raccolta?What is a collection?

Una raccolta è un gruppo di documenti con la logica dell'applicazione JavaScript associata.A collection is a group of documents and their associated JavaScript application logic. Una raccolta è un'entità fatturabile, in cui il costo è determinato dalla velocità effettiva e dallo spazio di archiviazione usato.A collection is a billable entity, where the cost is determined by the throughput and used storage. Le raccolte possono estendersi su una o più partizioni o server e possono essere ridimensionate per gestire volumi praticamente illimitati di archiviazione o velocità effettiva.Collections can span one or more partitions or servers and can scale to handle practically unlimited volumes of storage or throughput.

Le raccolte sono le entità di fatturazione anche per Azure Cosmos DB.Collections are also the billing entities for Azure Cosmos DB. Ogni raccolta viene fatturata su base oraria a seconda della velocità effettiva di provisioning e dello spazio di archiviazione usato.Each collection is billed hourly, based on the provisioned throughput and used storage space. Per altre informazioni, vedere Prezzi di Azure Cosmos DB.For more information, see Azure Cosmos DB Pricing.

Come si crea un database?How do I create a database?

È possibile creare database usando il portale di Azure, come descritto in Aggiungere una raccolta, uno degli SDK di Azure Cosmos DB o le API REST.You can create databases by using the Azure portal, as described in Add a collection, one of the Azure Cosmos DB SDKs, or the REST APIs.

Come è possibile configurare gli utenti e le autorizzazioni?How do I set up users and permissions?

È possibile creare utenti e autorizzazioni usando uno degli SDK per l'API di Cosmos DB o le API REST.You can create users and permissions by using one of the Cosmos DB API SDKs or the REST APIs.

L'API DocumentDB supporta SQL?Does the DocumentDB API support SQL?

Il linguaggio di query SQL è un sottoinsieme ottimizzato delle funzionalità di query supportate da SQL.The SQL query language is an enhanced subset of the query functionality that's supported by SQL. Il linguaggio di query SQL di Azure Cosmos DB offre operatori gerarchici e relazionali avanzati ed estendibilità tramite funzioni definite dall'utente basate su JavaScript.The Azure Cosmos DB SQL query language provides rich hierarchical and relational operators and extensibility via JavaScript-based, user-defined functions (UDFs). La grammatica JSON consente la modellazione di documenti JSON come alberi con nodi con etichetta, che vengono usati sia dalle tecniche di indicizzazione automatica di Azure Cosmos DB che dal dialetto di query SQL di Azure Cosmos DB.JSON grammar allows for modeling JSON documents as trees with labeled nodes, which are used by both the Azure Cosmos DB automatic indexing techniques and the SQL query dialect of Azure Cosmos DB. Per informazioni sull'uso della grammatica SQL, vedere l'articolo relativo alle query in DocumentDB.For information about using SQL grammar, see the QueryDocumentDB article.

L'API DocumentDB supporta le funzioni di aggregazione SQL?Does the DocumentDB API support SQL aggregation functions?

L'API DocumentDB supporta l'aggregazione a bassa latenza su qualsiasi scala con le funzioni di aggregazione COUNT, MIN, MAX, AVG e SUM tramite la grammatica SQL.The DocumentDB API supports low-latency aggregation at any scale via aggregate functions COUNT, MIN, MAX, AVG, and SUM via the SQL grammar. Per altre informazioni, vedere Funzioni di aggregazione.For more information, see Aggregate functions.

Come viene offerta la concorrenza nell'API DocumentDB?How does the DocumentDB API provide concurrency?

L'API DocumentDB supporta il controllo della concorrenza ottimistica tramite tag di entità HTTP (ETag).The DocumentDB API supports optimistic concurrency control (OCC) through HTTP entity tags, or ETags. Ogni risorsa dell'API DocumentDB ha un ETag, che viene impostato nel server ogni volta che un documento viene aggiornato.Every DocumentDB API resource has an ETag, and the ETag is set on the server every time a document is updated. In tutti i messaggi di risposta sono inclusi l'intestazione ETag e il valore corrente.The ETag header and the current value are included in all response messages. Gli ETag possono essere usati con l'intestazione If-Match per consentire al server di stabilire se una risorsa deve essere aggiornata.ETags can be used with the If-Match header to allow the server to decide whether a resource should be updated. Il valore di If-Match è il valore ETag con cui eseguire il confronto.The If-Match value is the ETag value to be checked against. Se il valore ETag corrisponde al valore ETag del server, la risorsa verrà aggiornata.If the ETag value matches the server ETag value, the resource is updated. Se l'ETag non è aggiornato, il server rifiuta l'operazione con un codice di risposta di tipo "HTTP 412 - Precondizione non riuscita".If the ETag is no longer current, the server rejects the operation with an "HTTP 412 Precondition failure" response code. Il client recupera quindi nuovamente la risorsa per acquisire il relativo valore ETag aggiornato.The client then re-fetches the resource to acquire the current ETag value for the resource. Inoltre, gli ETag possono essere usati con l'intestazione If-None-Match per stabilire se è necessario ripetere il recupero di una risorsa.In addition, ETags can be used with the If-None-Match header to determine whether a re-fetch of a resource is needed.

Per applicare la concorrenza ottimistica in .NET, usare la classe AccessCondition .To use optimistic concurrency in .NET, use the AccessCondition class. Per un esempio .NET, vedere Program.cs nell'esempio DocumentManagement in GitHub.For a .NET sample, see Program.cs in the DocumentManagement sample on GitHub.

Come si eseguono le transazioni nell'API DocumentDB?How do I perform transactions in the DocumentDB API?

L'API DocumentDB supporta transazioni integrate con il linguaggio tramite trigger e stored procedure JavaScript.The DocumentDB API supports language-integrated transactions via JavaScript-stored procedures and triggers. Tutte le operazioni su database negli script vengono eseguite con isolamento dello snapshot.All database operations inside scripts are executed under snapshot isolation. In caso di raccolta con partizione singola, l'ambito dell'esecuzione è limitato alla raccolta.If it is a single-partition collection, the execution is scoped to the collection. Se la raccolta è partizionata, l'ambito dell'esecuzione è limitato ai documenti con lo stesso valore di chiave di partizione all'interno della raccolta.If the collection is partitioned, the execution is scoped to documents with the same partition-key value within the collection. Viene acquisito uno snapshot delle versioni (ETag) del documento all'inizio della transazione e il commit della transazione viene eseguito solo se lo script ha esito positivo.A snapshot of the document versions (ETags) is taken at the start of the transaction and committed only if the script succeeds. Se JavaScript genera un errore, viene eseguito il rollback della transazione.If the JavaScript throws an error, the transaction is rolled back. Per altre informazioni, vedere Programmazione JavaScript lato server per Azure Cosmos DB.For more information, see Server-side JavaScript programming for Azure Cosmos DB.

Come è possibile eseguire inserimenti in blocco in Cosmos DB?How can I bulk-insert documents into Cosmos DB?

È possibile eseguire l'inserimento in blocco di documenti in Azure Cosmos DB in uno dei due modi seguenti:You can bulk-insert documents into Azure Cosmos DB in either of two ways:

Sì. Dato che Azure Cosmos DB è un servizio RESTful, i collegamenti alle risorse sono immutabili e possono essere memorizzati nella cache.Yes, because Azure Cosmos DB is a RESTful service, resource links are immutable and can be cached. I client dell'API DocumentDB possono specificare un'intestazione "If-None-Match" per le letture su qualsiasi raccolta o documento di tipo risorsa e quindi aggiornare le copie locali in seguito alla modifica della versione del server.DocumentDB API clients can specify an "If-None-Match" header for reads against any resource-like document or collection and then update their local copies after the server version has changed.

È disponibile un'istanza locale dell'API DocumentDB?Is a local instance of DocumentDB API available?

Sì.Yes. L'emulatore di Azure Cosmos DB offre un'emulazione estremamente fedele del servizio Cosmos DB.The Azure Cosmos DB Emulator provides a high-fidelity emulation of the Cosmos DB service. Supporta le stesse funzionalità di Azure Cosmos DB, incluso il supporto per la creazione e l'esecuzione di query su documenti JSON, il provisioning e il ridimensionamento delle raccolte e l'esecuzione di stored procedure e trigger.It supports functionality that's identical to Azure Cosmos DB, including support for creating and querying JSON documents, provisioning and scaling collections, and executing stored procedures and triggers. È possibile sviluppare e testare le applicazioni usando l'emulatore di Azure Cosmos DB e distribuirle in Azure su scala globale apportando una singola modifica di configurazione all'endpoint di connessione per Azure Cosmos DB.You can develop and test applications by using the Azure Cosmos DB Emulator, and deploy them to Azure at a global scale by making a single configuration change to the connection endpoint for Azure Cosmos DB.

Sviluppo con l'API per MongoDBDevelop against the API for MongoDB

Che cos'è l'API di Azure Cosmos DB per MongoDB?What is the Azure Cosmos DB API for MongoDB?

L'API di Azure Cosmos DB per MongoDB è un livello di compatibilità che consente alle applicazioni di comunicare in modo facile e trasparente con il motore di database nativo di Azure Cosmos DB usando le API e i driver di Apache MongoDB supportati dalla community.The Azure Cosmos DB API for MongoDB is a compatibility layer that allows applications to easily and transparently communicate with the native Azure Cosmos DB database engine by using existing, community-supported Apache MongoDB APIs and drivers. Gli sviluppatori possono ora usare le catene di strumenti e le competenze esistenti di MongoDB per creare applicazioni che sfruttano Azure Cosmos DB.Developers can now use existing MongoDB tool chains and skills to build applications that take advantage of Azure Cosmos DB. Gli sviluppatori possono trarre vantaggio dalle funzionalità specifiche di Azure Cosmos DB, tra cui l'indicizzazione automatica, la manutenzione di backup, i contratti di servizio con supporto finanziario e così via.Developers benefit from the unique capabilities of Azure Cosmos DB, which include auto-indexing, backup maintenance, financially backed service level agreements (SLAs), and so on.

Come ci si connette al database dell'API per MongoDB?How do I connect to my API for MongoDB database?

Il modo più veloce per connettersi all'API di Azure Cosmos DB per MongoDB consiste nel passare al portale di Azure.The quickest way to connect to the Azure Cosmos DB API for MongoDB is to head over to the Azure portal. Accedere al proprio account e quindi fare clic su Avvio rapido nel menu di spostamento a sinistra.Go to your account and then, on the left navigation menu, click Quick Start. Avvio rapido è l'approccio ottimale per ottenere i frammenti di codice per la connessione al database.Quick Start is the best way to get code snippets to connect to your database.

Azure Cosmos DB applica standard e requisiti di sicurezza rigidi.Azure Cosmos DB enforces strict security requirements and standards. Gli account Azure Cosmos DB richiedono l'autenticazione e la comunicazione sicura tramite SSL. Assicurarsi quindi di usare TLSv1.2.Azure Cosmos DB accounts require authentication and secure communication via SSL, so be sure to use TLSv1.2.

Per altre informazioni, vedere l'articolo su come connettersi al database dell'API per MongoDB.For more information, see Connect to your API for MongoDB database.

Sono disponibili codici errore aggiuntivi per un database dell'API per MongoDB?Are there additional error codes for an API for MongoDB database?

Oltre ai codici errore comuni di MongoDB, l'API per MongoDB include codici errore specifici:In addition to the common MongoDB error codes, the MongoDB API has its own specific error codes:

Tipi di erroreError CodiceCode DescrizioneDescription SoluzioneSolution
TooManyRequestsTooManyRequests 1650016500 Il numero totale di unità richiesta utilizzate ha superato il livello di unità richiesta di cui è stato effettuato il provisioning per la raccolta ed è stata applicata la limitazione.The total number of request units consumed has exceeded the provisioned request-unit rate for the collection and has been throttled. Valutare la possibilità di ridimensionare la velocità effettiva della raccolta dal portale di Azure o provare di nuovo.Consider scaling the throughput of the collection from the Azure portal or retrying again.
ExceededMemoryLimitExceededMemoryLimit 1650116501 In quanto servizio multi-tenant, l'operazione ha superato il limite di allocazione di memoria del client.As a multi-tenant service, the operation has exceeded the client's memory allotment. Ridurre l'ambito dell'operazione tramite criteri di query più restrittivi oppure contattare il supporto tecnico dal portale di Azure.Reduce the scope of the operation through more restrictive query criteria or contact support from the Azure portal.

Esempio:     db.getCollection('users').aggregate([
        {$match: {name: "Andy"}},
        {$sort: {age: -1}}
    ])
)
Example:     db.getCollection('users').aggregate([
        {$match: {name: "Andy"}},
        {$sort: {age: -1}}
    ])
)

Sviluppare con l'API TabelleDevelop with the Table API

Come si può usare l'offerta API Tabelle?How can I use the Table API offering?

L'API Table di Azure Cosmos DB è disponibile nel portale di Azure.The Azure Cosmos DB Table API is available in the Azure portal. Per prima cosa, è necessario iscriversi per ottenere una sottoscrizione di Azure.First you must sign up for an Azure subscription. Dopo aver effettuato l'iscrizione, è possibile aggiungere un account API Table di Azure Cosmos DB alla sottoscrizione di Azure e quindi aggiungere tabelle all'account.After you've signed up, you can add an Azure Cosmos DB Table API account to your Azure subscription, and then add tables to your account.

Per informazioni sui linguaggi supportati e sulle guide introduttive associate, vedere Introduzione all'API Tabelle di Azure Cosmos DB.You can find the supported languages and associated quick-starts in the Introduction to Azure Cosmos DB Table API.

È necessario un nuovo SDK per usare l'API Tabelle?Do I need a new SDK to use the Table API?

No, gli SDK di archiviazione esistenti dovrebbero funzionare ancora.No, existing storage SDKs should still work. È tuttavia consigliabile ottenere sempre gli SDK più recenti per assicurare il supporto migliore e in molti casi prestazioni superiori.However it is recommended that one always gets the latest SDKs for the best support and in many cases superior performance. Per un elenco dei linguaggi supportati, vedere Introduzione all'API Tabelle di Azure Cosmos DB.See the list of available languages in the Introduction to Azure Cosmos DB Table API.

Quali sono le differenze tra il comportamento dell'API Tabelle e quello dell'archiviazione tabelle di Azure?Where is Table API not identical with Azure Table storage behavior?

Esistono alcune differenze a livello di comportamento che gli utenti di archiviazione tabelle di Azure che vogliono creare tabelle con l'API Tabelle di Azure Cosmos DB devono tenere in considerazione:There are some behavior differences that users coming from Azure Table storage who want to create tables with the Azure Cosmos DB Table API should be aware of:

  • L'API Tabelle di Azure Cosmos DB usa un modello di capacità riservata per assicurare prestazioni garantite, ma ciò comporta il pagamento della capacità non appena viene creata la tabella, anche se la capacità non viene usata.Azure Cosmos DB Table API uses a reserved capacity model in order to ensure guaranteed performance but this means that one pays for the capacity as soon as the table is created, even if the capacity isn't being used. L'archiviazione tabelle di Azure prevede solo il pagamento della capacità effettivamente usata.With Azure Table storage one only pays for capacity that is actually used. Questo è il motivo per cui l'API Tabelle può offrire un contratto di servizio con 10 ms di lettura e 15 ms di scrittura al 99% mentre l'archiviazione tabelle di Azure offre un contratto di servizio con 10 secondi.This helps to explain why Table API can offer a 10 ms read and 15 ms write SLA at the 99th percentile while Azure Table storage offers a 10 second SLA. Con l'API Tabelle, tuttavia, sono previsti costi anche per le tabelle vuote senza richieste, in modo da assicurare che sia disponibile la capacità per la gestione di eventuali richieste in base al contratto di servizio offerto da Azure Cosmos DB.But as a consequence, with Table API tables, even empty tables without any requests, cost money in order to ensure the capacity is available to handle any requests to them at the SLA offered by Azure Cosmos DB.
  • I risultati delle query restituiti dall'API Tabelle non vengono ordinati in base a chiave di partizione/chiave di riga, come avviene in archiviazione tabelle di Azure.Query results returned by the Table API are not sorted in partition key/row key order as they are in Azure Table storage.
  • Le chiavi di riga possono avere una dimensione massima di 255 byte.Row keys can only be up to 255 bytes
  • I batch possono contenere solo fino a 2 MBBatches can only contain up to 2 MBs
  • CORS non è attualmente supportato.CORS is not currently supported
  • I nomi di tabella nell'archiviazione tabelle di Azure non rispettano la distinzione tra maiuscole e minuscole, ma tale distinzione viene rispettata nell'API Tabelle di Azure Cosmos DB.Table names in Azure Table storage are not case-sensitive, but they are in Azure Cosmos DB Table API
  • Alcuni dei formati interni di Azure Cosmos DB per le informazioni di codifica, ad esempio i campi binari, non offrono attualmente l'efficienza auspicabile.Some of Azure Cosmos DB's internal formats for encoding information, such as binary fields, are currently not as efficient as one might like. Di conseguenza questo può causare limitazioni impreviste per le dimensioni dei dati.Therefore this can cause unexpected limitations on data size. Ad esempio, attualmente non è possibile usare l'intero MB di un'entità tabella per archiviare i dati binari, perché la codifica incrementa le dimensioni dei dati.For example, currently one couldn't use the full 1 Meg of a table entity to store binary data because the encoding increases the data's size.

Per quanto riguarda l'API REST, sono disponibili alcune opzioni relative a endpoint/query non supportate dall'API Tabelle di Azure Cosmos DB:In terms of the REST API there are a number of endpoints/query options that are not supported by Azure Cosmos DB Table API:

Metodi RESTRest Method(s) Opzione relativa a endpoint/query RESTRest Endpoint/Query Option URL della documentazioneDoc URLs SpiegazioneExplanation
GET, PUTGET, PUT /?restype=service@comp=properties/?restype=service@comp=properties Set Table Service Properties (Operazione Set Table Service Properties) Get Table Service Properties (Operazione Get Table Service Properties)Set Table Service Properties and Get Table Service Properties Questo endpoint viene usato per configurare le regole CORS, la configurazione di analisi di archiviazione e le impostazioni di registrazione.This endpoint is used to set CORS rules, storage analytics configuration, and logging settings. CORS non è attualmente supportato e l'analisi e la registrazione vengono gestite in modo diverso in Azure Cosmos DB rispetto ad archiviazione tabelle di Azure.CORS is currently not supported and analytics and logging are handled differently in Azure Cosmos DB than Azure Storage Tables
OPTIONSOPTIONS // Pre-flight CORS table request (Operazione Pre-flight CORS table request)Pre-flight CORS table request Questa è una parte di CORS che non è attualmente supportata da Azure Cosmos DB.This is part of CORS which Azure Cosmos DB does not currently support.
GETGET /?restype=service@comp=stats/?restype=service@comp=stats Get Table Service Stats (Operazione Get Table Service Stats)Get Table Service Stats Fornisce informazioni sulla velocità con cui i dati vengono replicati tra il server primario e i server secondari.Provides information how quickly data is replicating between primary and secondaries. Non è necessario in Cosmos DB perché la replica fa parte delle operazioni di scrittura.This isn't needed in Cosmos DB as the replication is part of writes.
GET, PUTGET, PUT /mytable?comp=acl/mytable?comp=acl Get Table ACL (Operazione Get Table ACL) e Set Table ACL (Operazione Set Table ACL)Get Table ACL and Set Table ACL Ottiene e configura i criteri di accesso archiviati usati per gestire le firme di accesso condiviso.This gets and sets the stored access policies used to manage Shared Access Signatures (SAS). Anche se la firma di accesso condiviso è supportata, viene configurata e gestita in modo diverso.Although SAS is supported, they are set and managed differently.

L'API Tabelle di Azure Cosmos DB supporta inoltre il formato JSON, non ATOM.In addition Azure Cosmos DB Table API only supports the JSON format, not ATOM.

Nonostante Azure Cosmos DB supporti le firme di accesso condiviso, non supporta alcuni criteri, in particolare i criteri correlati alle operazioni di gestione, ad esempio il diritto di creare nuove tabelle.While Azure Cosmos DB supports Shared Access Signatures (SAS) there are certain policies it doesn't support, specifically those related to management operations such as the right to create new tables.

Per .NET SDK in particolare alcune classi e alcuni metodi non sono attualmente supportati da Azure Cosmos DB.For the .NET SDK in particular, there are some classes and methods that Azure Cosmos DB does not currently support.

ClasseClass Metodo non supportatoUnsupported Method
CloudTableClientCloudTableClient *ServiceProperties*ServiceProperties
*ServiceStats*ServiceStats
CloudTableCloudTable SetPermissionsSetPermissions
GetPermissionsGetPermissions
TableServiceContextTableServiceContext * (questa classe è in effetti deprecata)* (this class is actually deprecated)
TableServiceEntityTableServiceEntity " "" "
TableServiceExtensionsTableServiceExtensions " "" "
TableServiceQueryTableServiceQuery " "" "

Se queste differenze costituiscono un problema per il progetto, contattare askcosmosdb@microsoft.com e segnalare il problema.If any of these differences are a problem for your project please contact askcosmosdb@microsoft.com and let us know.

Come si forniscono commenti e suggerimenti sull'SDK o sui bug?How do I provide feedback about the SDK or bugs?

È possibile condividere commenti e suggerimenti in uno dei modi seguenti:You can share your feedback in any of the following ways:

Quale stringa di connessione è necessario usare per connettersi all'API Tabelle?What is the connection string that I need to use to connect to the Table API?

La stringa di connessione è:The connection string is:

DefaultEndpointsProtocol=https;AccountName=<AccountNamefromCosmos DB;AccountKey=<FromKeysPaneofCosmosDB>;TableEndpoint=https://<AccountNameFromDocumentDB>.table.cosmosdb.azure.com

È possibile ottenere la stringa di connessione nella pagina Stringa di connessione del portale di Azure.You can get the connection string from the Connection String page in the Azure portal.

Come si sostituiscono le impostazioni di configurazione per le opzioni relative alle richieste in .NET SDK per l'API Tabelle?How do I override the config settings for the request options in the .NET SDK for the Table API?

Per informazioni sulle impostazioni di configurazione, vedere Funzionalità di Azure Cosmos DB.For information about config settings, see Azure Cosmos DB capabilities. Alcune impostazioni vengono gestite nel metodo CreateCloudTableClient e altre tramite il file app.config nella sezione appSettings dell'applicazione client.Some settings are handled on the CreateCloudTableClient method and other via the app.config in the appSettings section in the client application.

Sono stati introdotti cambiamenti per i clienti che usano gli SDK di archiviazione tabelle di Azure?Are there any changes for customers who are using the existing Azure Table storage SDKs?

Nessuna.None. Non è stato introdotto alcun cambiamento per i clienti nuovi o esistenti che usano gli SDK di archiviazione tabelle di Azure esistenti.There are no changes for existing or new customers who are using the existing Azure Table storage SDKs.

Come si visualizzano i dati di tabella archiviati in Azure Cosmos DB da usare con l'API Tabelle?How do I view table data that is stored in Azure Cosmos DB for use with the Table API?

Per esplorare i dati si può usare il portale di Azure.You can use the Azure portal to browse the data. È anche possibile usare il codice dell'API Tabelle o gli strumenti illustrati nella risposta successiva.You can also use the Table API code or the tools mentioned in the next answer.

Quali strumenti è possibile usare con l'API Tabelle?Which tools work with the Table API?

È possibile usare Azure Storage Explorer.You can use the Azure Storage Explorer.

La nuova API Tabelle è supportata dagli strumenti sufficientemente flessibili da accettare una stringa di connessione nel formato specificato in precedenza.Tools with the flexibility to take a connection string in the format specified previously can support the new Table API. Per un elenco degli strumenti di tabella, vedere la pagina Strumenti client di Archiviazione di Azure.A list of table tools is provided on the Azure Storage Client Tools page.

È possibile usare PowerShell o l'interfaccia della riga di comando di Azure con l'API Tabelle?Do PowerShell or Azure CLI work with the Table API?

È disponibile il supporto per PowerShell.There is support for PowerShell. Il supporto per l'interfaccia della riga di comando di Azure non è attualmente disponibile.Azure CLI support is not currently available.

La concorrenza nelle operazioni è controllata?Is the concurrency on operations controlled?

Sì. La concorrenza ottimistica è supportata tramite l'uso del meccanismo degli ETag.Yes, optimistic concurrency is provided via the use of the ETag mechanism.

È supportato il modello di query OData per le entità?Is the OData query model supported for entities?

Sì. L'API Tabelle supporta query OData e query LINQ.Yes, the Table API supports OData query and LINQ query.

È supportata la connessione affiancata tra archiviazione tabelle di Azure e l'API Tabelle di Azure Cosmos DB?Can I connect to Azure Table Storage and Azure Cosmos DB Table API side by side in the same application?

Sì. È possibile connettersi creando due istanze separate di CloudTableClient, ognuna delle quali punta a un URI specifico tramite la stringa di connessione.Yes, you can connect by creating two separate instances of the CloudTableClient, each pointing to its own URI via the connection string.

Come si esegue la migrazione di un'applicazione di archiviazione tabelle di Azure esistente a questa offerta?How do I migrate an existing Azure Table storage application to this offering?

Sono supportati AzCopy e l'Utilità di migrazione dati di Azure Cosmos DB.AzCopy and the Azure Cosmos DB Data Migration Tool are both supported.

Come si espandono le dimensioni di archiviazione per questo servizio, se ad esempio n GB di dati iniziali crescono nel tempo fino a 1 TB?How is expansion of the storage size done for this service if, for example, I start with n GB of data and my data will grow to 1 TB over time?

Azure Cosmos DB è progettato per offrire spazio di archiviazione illimitato tramite scalabilità orizzontale.Azure Cosmos DB is designed to provide unlimited storage via the use of horizontal scaling. Il servizio può monitorare e aumentare efficacemente lo spazio di archiviazione.The service can monitor and effectively increase your storage.

Come si monitora l'offerta dell'API Tabelle?How do I monitor the Table API offering?

È possibile usare il riquadro Metriche dell'API Tabelle per monitorare le richieste e l'utilizzo dello spazio di archiviazione.You can use the Table API Metrics pane to monitor requests and storage usage.

Come si calcola la velocità effettiva necessaria?How do I calculate the throughput I require?

È possibile usare lo strumento di stima della capacità per calcolare il valore di TableThroughput necessario per le operazioni.You can use the capacity estimator to calculate the TableThroughput that's required for the operations. Per altre informazioni, vedere Estimate Request Units and Data Storage (Stimare le unità richiesta e l'archiviazione dei dati).For more information, see Estimate Request Units and Data Storage. In generale, è possibile rappresentare un'entità in formato JSON e specificare i numeri relativi alle operazioni.In general, you can represent your entity as JSON and provide the numbers for your operations.

È possibile usare l'SDK dell'API Tabelle in locale con l'emulatore?Can I use the Table API SDK locally with the emulator?

Attualmente non è possibile.Not at this time.

È possibile usare un'applicazione esistente con l'API Tabelle?Can my existing application work with the Table API?

Sì, è supportata la stessa API.Yes, the same API is supported.

È necessario eseguire la migrazione delle applicazioni di archiviazione tabelle di Azure esistenti all'SDK se non si vogliono usare le funzionalità dell'API Tabelle?Do I need to migrate my existing Azure Table storage applications to the SDK if I do not want to use the Table API features?

No. È possibile creare e usare asset di archiviazione tabelle di Azure esistenti senza interruzioni di alcun tipo.No, you can create and use existing Azure Table storage assets without interruption of any kind. Se non si usa l'API Tabelle, tuttavia, non è possibile usufruire dell'indicizzazione automatica, dell'opzione di coerenza aggiuntiva o della distribuzione globale.However, if you do not use the Table API, you cannot benefit from the automatic index, the additional consistency option, or global distribution.

Come si aggiunge la replica dei dati nell'API Tabelle in più aree di Azure?How do I add replication of the data in the Table API across multiple regions of Azure?

È possibile usare le impostazioni di replica globale del portale di Azure Cosmos DB per aggiungere le aree idonee per l'applicazione.You can use the Azure Cosmos DB portal’s global replication settings to add regions that are suitable for your application. Per sviluppare un'applicazione distribuita a livello globale, è consigliabile anche aggiungere l'applicazione con il valore di PreferredLocation impostato sull'area locale, per garantire una bassa latenza di lettura.To develop a globally distributed application, you should also add your application with the PreferredLocation information set to the local region for providing low read latency.

Come si modifica l'area di scrittura primaria per l'account nell'API Tabelle?How do I change the primary write region for the account in the Table API?

È possibile usare il riquadro del portale relativo alla replica globale di Azure Cosmos DB per aggiungere un'area e quindi effettuare il failover nell'area necessaria.You can use the Azure Cosmos DB global replication portal pane to add a region and then fail over to the required region. Per istruzioni, vedere l'articolo relativo allo sviluppo con account Azure Cosmos DB tra più aree.For instructions, see Developing with multi-region Azure Cosmos DB accounts.

Come si configurano le aree di lettura preferite per una bassa latenza quando si distribuiscono i dati?How do I configure my preferred read regions for low latency when I distribute my data?

Per facilitare la lettura dalla località locale, usare la chiave PreferredLocation nel file app.config.To help read from the local location, use the PreferredLocation key in the app.config file. Per le applicazioni esistenti, l'API Tabelle genera un errore in caso di impostazione di LocationMode.For existing applications, the Table API throws an error if LocationMode is set. Rimuovere tale codice, perché l'API Tabelle acquisisce queste informazioni dal file app.config.Remove that code, because the Table API picks up this information from the app.config file. Per altre informazioni, vedere Funzionalità di Azure Cosmos DB.For more information, see Azure Cosmos DB capabilities.

Come funzionano i livelli di coerenza nell'API Tabelle?How should I think about consistency levels in the Table API?

Azure Cosmos DB offre compromessi ben ponderati tra coerenza, disponibilità e latenza.Azure Cosmos DB provides well-reasoned trade-offs between consistency, availability, and latency. Azure Cosmos DB offre cinque livelli di coerenza per gli sviluppatori che usano l'API Tabelle, consentendo così di scegliere il modello di coerenza appropriato a livello di tabella ed effettuare singole richieste durante l'esecuzione di query sui dati.Azure Cosmos DB offers five consistency levels to Table API developers, so you can choose the right consistency model at the table level and make individual requests while querying the data. Quando un client si connette, può specificare un livello di coerenza.When a client connects, it can specify a consistency level. È possibile modificare il livello tramite l'argomento consistencyLevel di CreateCloudTableClient.You can change the level via the consistencyLevel argument of CreateCloudTableClient.

L'API Tabelle offre letture a bassa latenza con la "lettura delle proprie scritture", con la coerenza con obsolescenza associata come impostazione predefinita.The Table API provides low-latency reads with "Read your own writes," with Bounded-staleness consistency as the default. Per altre informazioni, vedere l'articolo relativo ai livelli di coerenza.For more information, see Consistency levels.

Per impostazione predefinita, l'archivio tabelle di Azure offre coerenza assoluta all'interno di un'area e coerenza finale nelle località secondarie.By default, Azure Table storage provides Strong consistency within a region and Eventual consistency in the secondary locations.

L'API Tabelle di Azure Cosmos DB offre più livelli di coerenza rispetto all'archiviazione tabelle di Azure?Does Azure Cosmos DB Table API offer more consistency levels than Azure Table storage?

Sì. Per informazioni su come trarre vantaggio dalla natura distribuita di Azure Cosmos DB, vedere l'articolo relativo ai livelli di coerenza.Yes, for information about how to benefit from the distributed nature of Azure Cosmos DB, see Consistency levels. Grazie alle garanzie associate ai livelli di coerenza, possono essere usati in tutta sicurezza.Because guarantees are provided for the consistency levels, you can use them with confidence. Per altre informazioni, vedere Funzionalità di Azure Cosmos DB.For more information, see Azure Cosmos DB capabilities.

Quando è abilitata la distribuzione globale, quanto tempo è necessario per replicare i dati?When global distribution is enabled, how long does it take to replicate the data?

Azure Cosmos DB esegue il commit permanente dei dati nell'area locale e ne effettua immediatamente il push in altre aree, nell'arco di millisecondi.Azure Cosmos DB commits the data durably in the local region and pushes the data to other regions immediately in a matter of milliseconds. Questa replica dipende solo dal tempo di round trip del data center.This replication is dependent only on the round-trip time (RTT) of the datacenter. Per altre informazioni sulla funzionalità di distribuzione globale di Azure Cosmos DB, vedere l'articolo relativo ad Azure Cosmos DB come servizio di database distribuito a livello globale in Azure.To learn more about the global-distribution capability of Azure Cosmos DB, see Azure Cosmos DB: A globally distributed database service on Azure.

È possibile modificare il livello di coerenza delle richieste di lettura?Can the read request consistency level be changed?

Con Azure Cosmos DB, è possibile impostare il livello di coerenza a livello di contenitore (nella tabella).With Azure Cosmos DB, you can set the consistency level at the container level (on the table). Usando .NET SDK, si può modificare il livello specificando il valore della chiave TableConsistencyLevel nel file app.config.By using the .NET SDK, you can change the level by providing the value for TableConsistencyLevel key in the app.config file. I valori possibili sono: Strong, Bounded Staleness, Session, Consistent Prefix ed Eventual.The possible values are: Strong, Bounded Staleness, Session, Consistent Prefix, and Eventual. Per altre informazioni, vedere Livelli di coerenza dei dati ottimizzabili in Azure Cosmos DB.For more information, see Tunable data consistency levels in Azure Cosmos DB. Il concetto chiave è che non è possibile impostare un livello di coerenza delle richieste superiore rispetto all'impostazione della tabella.The key idea is that you cannot set the request consistency level at more than the setting for the table. Ad esempio, non è possibile impostare il livello di coerenza Eventual per la tabella e il livello di coerenza Strong per le richieste.For example, you cannot set the consistency level for the table at Eventual and the request consistency level at Strong.

Come viene gestito il failover dall'API Tabelle se un'area diventa inattiva?How does the Table API handle failover if a region goes down?

L'API Tabelle sfrutta i vantaggi della piattaforma distribuita a livello globale di Azure Cosmos DB.The Table API leverages the globally distributed platform of Azure Cosmos DB. Affinché l'applicazione possa tollerare i tempi di inattività del data center, abilitare almeno un'altra area per l'account nel portale di Azure Cosmos DB, come illustrato nell'articolo relativo allo sviluppo con account Azure Cosmos DB tra più aree.To ensure that your application can tolerate datacenter downtime, enable at least one more region for the account in the Azure Cosmos DB portal Developing with multi-region Azure Cosmos DB accounts. Si può impostare la priorità dell'area usando il portale. Vedere l'articolo relativo allo sviluppo con account Azure Cosmos DB tra più aree.You can set the priority of the region by using the portal Developing with multi-region Azure Cosmos DB accounts.

È possibile aggiungere il numero di aree desiderato per l'account e controllare in quale potrà essere effettuato il failover specificando una priorità di failover.You can add as many regions as you want for the account and control where it can fail over to by providing a failover priority. Per usare il database, è necessario includere anche un'applicazione.Of course, to use the database, you need to provide an application there too. Nel corso di questa operazione, i clienti non riscontrano tempi di inattività.When you do so, your customers will not experience downtime. A differenza degli altri SDK, l'SDK client .NET più recente include l'hosting automatico.The latest .NET client SDK is auto homing but the other SDKs are not. ovvero può rilevare l'area inattiva ed effettuare automaticamente il failover nella nuova area.That is, it can detect the region that's down and automatically fail over to the new region.

L'API Tabelle è abilitata per il backup?Is the Table API enabled for backups?

Sì, l'API Tabelle sfrutta i vantaggi della piattaforma di Azure Cosmos DB per i backup.Yes, the Table API leverages the platform of Azure Cosmos DB for backups. I backup vengono eseguiti automaticamente.Backups are made automatically. Per altre informazioni, vedere Backup online automatico e ripristino con Azure Cosmos DB.For more information, see Online backup and restore with Azure Cosmos DB.

L'API Tabelle indicizza tutti gli attributi di un'entità per impostazione predefinita?Does the Table API index all attributes of an entity by default?

Sì. Per impostazione predefinita vengono indicizzati tutti gli attributi di un'entità.Yes, all attributes of an entity are indexed by default. Per altre informazioni, vedere l'articolo relativo ai criteri di indicizzazione di Azure Cosmos DB.For more information, see Azure Cosmos DB: Indexing policies.

Per soddisfare le query è quindi necessario creare più indici?Does this mean I do not have to create multiple indexes to satisfy the queries?

Sì. L'API Tabelle di Azure Cosmos DB offre l'indicizzazione automatica di tutti gli attributi senza definizione di schema.Yes, Azure Cosmos DB Table API provides automatic indexing of all attributes without any schema definition. Questa automazione consente agli sviluppatori di concentrarsi sull'applicazione anziché sulla creazione e sulla gestione degli indici.This automation frees developers to focus on the application rather than on index creation and management. Per altre informazioni, vedere l'articolo relativo ai criteri di indicizzazione di Azure Cosmos DB.For more information, see Azure Cosmos DB: Indexing policies.

È possibile modificare i criteri di indicizzazione?Can I change the indexing policy?

Sì. È possibile modificare i criteri di indicizzazione specificando la definizione di indice.Yes, you can change the indexing policy by providing the index definition. Per altre informazioni, vedere Funzionalità di Azure Cosmos DB.For more information, see Azure Cosmos DB capabilities. È necessario eseguire correttamente la codifica e l'escape delle impostazioni.You need to properly encode and escape the settings.

Per gli SDK non .NET è possibile configurare i criteri di indicizzazione solo nel portale in Esplora dati. Passare alla tabella specifica da modificare, quindi selezionare Scale & Settings (Scalabilità e impostazioni)->Criteri di indicizzazione, apportare le modifiche e quindi scegliere Salva.for the non-.NET SDKs the indexing policy can only be set in the portal at Data Explorer, navigate to the specific table you want to change and then go to the Scale & Settings->Indexing Policy, make the desired change and then Save.

Da .NET SDK è possibile inviare i criteri nel file app.config:From the .NET SDK it can be submitted in the app.config file:

{
  "indexingMode": "consistent",
  "automatic": true,
  "includedPaths": [
    {
      "path": "/somepath",
      "indexes": [
        {
          "kind": "Range",
          "dataType": "Number",
          "precision": -1
        },
        {
          "kind": "Range",
          "dataType": "String",
          "precision": -1
        } 
      ]
    }
  ],
  "excludedPaths": 
[
 {
      "path": "/anotherpath"
 }
]
}

Come piattaforma, Azure Cosmos DB offre numerose funzionalità, come l'ordinamento, le aggregazioni, la gerarchia e così via.Azure Cosmos DB as a platform seems to have lot of capabilities, such as sorting, aggregates, hierarchy, and other functionality. Queste funzionalità verranno aggiunte all'API Table?Will you be adding these capabilities to the Table API?

L'API Tabelle offre le stesse funzionalità di query dell'archiviazione tabelle di Azure.The Table API provides the same query functionality as Azure Table storage. Azure Cosmos DB supporta anche l'ordinamento, le aggregazioni, le query geospaziali, la gerarchia e un'ampia gamma di funzioni predefinite.Azure Cosmos DB also supports sorting, aggregates, geospatial query, hierarchy, and a wide range of built-in functions. Le funzionalità aggiuntive verranno incluse nell'API Table in un aggiornamento futuro del servizio.We will provide additional functionality in the Table API in a future service update. Per altre informazioni, vedere Query SQL per l'API di DocumentDB di Azure Cosmos DB.For more information, see SQL queries for Azure Cosmos DB DocumentDB API.

Quando è consigliabile modificare TableThroughput per l'API Tabelle?When should I change TableThroughput for the Table API?

È consigliabile modificare TableThroughput quando si verifica una delle condizioni seguenti:You should change TableThroughput when either of the following conditions applies:

  • Si esegue un'operazione di estrazione, trasformazione e caricamento (ETL) di dati o si vuole caricare una grande quantità di dati in breve tempo.You're performing an extract, transform, and load (ETL) of data, or you want to upload a lot of data in short amount of time.
  • È necessaria una velocità effettiva superiore dal contenitore al back-end.You need more throughput from the container at the back end. Ad esempio, si rileva che la velocità effettiva usata è superiore alla velocità effettiva di provisioning e viene applicata la limitazione.For example, you see that the used throughput is more than the provisioned throughput, and you are getting throttled. Per altre informazioni, vedere Impostare la velocità effettiva per i contenitori di Azure Cosmos DB.For more information, see Set throughput for Azure Cosmos DB containers.

È possibile aumentare o ridurre la velocità effettiva di una tabella dell'API Tabelle?Can I scale up or scale down the throughput of my Table API table?

Sì. È possibile usare il riquadro relativo alla scalabilità del portale di Azure Cosmos DB per ridimensionare la velocità effettiva.Yes, you can use the Azure Cosmos DB portal’s scale pane to scale the throughput. Per altre informazioni, vedere l'articolo su come impostare la velocità effettiva.For more information, see Set throughput.

Per le tabelle appena sottoposte a provisioning viene impostato un valore predefinito di TableThroughput?Is a default TableThroughput set for newly provisioned tables?

Sì. Se non si sostituisce il valore di TableThroughput in app.config e non si usa un contenitore già creato in Azure Cosmos DB, il servizio crea una tabella con velocità effettiva di 400.Yes, if you do not override the TableThroughput via app.config and do not use a pre-created container in Azure Cosmos DB, the service creates a table with throughput of 400.

I prezzi per i clienti esistenti del servizio archiviazione tabelle di Azure sono cambiati?Is there any change of pricing for existing customers of the Azure Table storage service?

Nessuna.None. Il prezzo per i clienti esistenti dell'archiviazione tabelle di Azure non è cambiato.There is no change in price for existing Azure Table storage customers.

Come viene calcolato il prezzo per l'API Tabelle?How is the price calculated for the Table API?

Il prezzo dipende dal valore di TableThroughput allocato.The price depends on the allocated TableThroughput.

Come si gestisce l'eventuale limitazione nelle tabelle dell'offerta dell'API Tabelle?How do I handle any throttling on the tables in Table API offering?

Se la frequenza delle richieste supera la capacità della velocità effettiva di provisioning per il contenitore sottostante, verrà restituito un errore e l'SDK ripeterà la chiamata applicando i criteri di ripetizione dei tentativi.If the request rate exceeds the capacity of the provisioned throughput for the underlying container, you get an error, and the SDK retries the call by applying the retry policy.

Perché è necessario scegliere una velocità effettiva oltre alla chiave di partizione e alla chiave di riga per sfruttare i vantaggi dell'offerta API Tabelle di Azure Cosmos DB?Why do I need to choose a throughput apart from PartitionKey and RowKey to take advantage of the Table API offering of Azure Cosmos DB?

Azure Cosmos DB imposta una velocità effettiva predefinita per il contenitore, se non se ne specifica una nel file app.config o tramite il portale.Azure Cosmos DB sets a default throughput for your container if you do not provide one in the app.config file or via the portal.

Azure Cosmos DB offre garanzie di prestazioni e latenza, con limiti superiori nelle operazioni.Azure Cosmos DB provides guarantees for performance and latency, with upper bounds on operation. Questa garanzia è possibile quando il motore può applicare la governance nelle operazioni del tenant.This guarantee is possible when the engine can enforce governance on the tenant's operations. L'impostazione di TableThroughput assicura la velocità effettiva e la latenza garantite, perché la piattaforma riserva tale capacità e garantisce l'esito positivo delle operazioni.Setting TableThroughput ensures that you get the guaranteed throughput and latency, because the platform reserves this capacity and guarantees operational success.

È possibile usare la specifica della velocità effettiva modificandola in modo elastico per trarre vantaggio dalla stagionalità dell'applicazione, soddisfare le esigenze in termini di velocità effettiva e ridurre i costi.By using the throughput specification, you can elastically change it to benefit from the seasonality of your application, meet the throughput needs, and save costs.

Archiviazione tabelle di può essere molto economico se si eseguono raramente query, perché si paga solo per l'archiviazione dei dati.Azure Table storage has been very inexpensive for me, because I pay only to store the data, and I rarely query. Con l'offerta relativa all'API Tabelle di Azure Cosmos DB sembra che vengano effettuati addebiti anche se non si esegue alcuna transazione o non si archiviano dati.The Azure Cosmos DB Table API offering seems to be charging me even though I have not performed a single transaction or stored anything. Perché?Can you please explain?

Azure Cosmos DB è progettato come un sistema basato su contratti di servizio distribuito a livello globale con garanzie di disponibilità, latenza e velocità effettiva.Azure Cosmos DB is designed to be a globally distributed, SLA-based system with guarantees for availability, latency, and throughput. La velocità effettiva riservata in Azure Cosmos DB è garantita, a differenza della velocità effettiva di altri sistemi.When you reserve throughput in Azure Cosmos DB, it is guaranteed, unlike the throughput of other systems. Azure Cosmos DB offre funzionalità aggiuntive che sono state richieste dai clienti, come gli indici secondari e la distribuzione globale.Azure Cosmos DB provides additional capabilities that customers have requested, such as secondary indexes and global distribution.

Quando si inseriscono dati nell'archiviazione tabelle di Azure, non viene mai visualizzata una notifica di raggiungimento della quota che indica che la partizione è piena.I never get a “quota full" notification (indicating that a partition is full) when I ingest data into Azure Table storage. Con l'API Tabelle viene visualizzato questo messaggio.With the Table API, I do get this message. Questa offerta impone limitazioni e la modifica dell'applicazione esistente?Is this offering limiting me and forcing me to change my existing application?

Azure Cosmos DB è un sistema basato su contratti di servizio che offre scalabilità illimitata, con garanzie di latenza, velocità effettiva, disponibilità e coerenza.Azure Cosmos DB is an SLA-based system that provides unlimited scale, with guarantees for latency, throughput, availability, and consistency. Per assicurarsi le prestazioni Premium garantite, verificare che l'indice e le dimensioni dei dati siano gestibili e scalabili.To ensure guaranteed premium performance, make sure that your data size and index are manageable and scalable. Il limite di 10 GB per il numero di entità o elementi per chiave di partizione ha lo scopo di assicurare prestazioni di ricerca e di query elevate.The 10-GB limit on the number of entities or items per partition key is to ensure that we provide great lookup and query performance. Per garantire la scalabilità dell'applicazione anche per Archiviazione di Azure, è consigliabile non creare una partizione critica archiviando tutte le informazioni in una partizione ed eseguendo query su di essa.To ensure that your application scales well, even for Azure Storage, we recommend that you not create a hot partition by storing all information in one partition and querying it.

La chiave di partizione e la chiave di riga sono ancora necessarie con l'API Tabelle?So PartitionKey and RowKey are still required with the Table API?

Sì.Yes. Dato che la superficie di attacco dell'API Tabelle è simile a quella di Azure Table Storage SDK, la chiave di partizione offre un modo efficiente per distribuire i dati.Because the surface area of the Table API is similar to that of the Azure Table storage SDK, the partition key provides an efficient way to distribute the data. La chiave di riga è univoca all'interno della partizione.The row key is unique within that partition. La chiave di riga deve essere presente e non può essere Null come nell'SDK standard.The row key needs to be present and can't be null as in the standard SDK. La chiave di riga è lunga 255 byte, mentre la chiave di partizione ha una lunghezza di 1 KB.The length of RowKey is 255 bytes and the length of PartitionKey is 1 KB.

Quali sono i messaggi di errore per l'API Tabelle?What are the error messages for the Table API?

L'archiviazione tabelle di Azure e l'API Tabelle di Azure Cosmos DB usano gli stessi SDK, quindi la maggior parte degli errori sarà uguale.Azure Table storage and Azure Cosmos DB Table API use the same SDKs so most of the errors will be the same.

Perché quando si prova a creare numerose tabelle una dopo l'altra nell'API Tabelle viene applicata la limitazione?Why do I get throttled when I try to create lot of tables one after another in the Table API?

Azure Cosmos DB è un sistema basato su contratti di servizio che offre garanzie di latenza, velocità effettiva, disponibilità e coerenza.Azure Cosmos DB is an SLA-based system that provides latency, throughput, availability, and consistency guarantees. Dato che è un sistema con provisioning, riserva risorse per garantire tali requisiti.Because it is a provisioned system, it reserves resources to guarantee these requirements. La rapida frequenza di creazione delle tabelle viene rilevata e limitata.The rapid rate of creation of tables is detected and throttled. È consigliabile esaminare la frequenza di creazione di tabelle e ridurla a meno di 5 al minuto.We recommend that you look at the rate of creation of tables and lower it to less than 5 per minute. Tenere presente che l'API Tabelle è un sistema con provisioning.Remember that the Table API is a provisioned system. Il relativo pagamento ha inizio nel momento in cui ne viene effettuato il provisioning.The moment you provision it, you will begin to pay for it.

Sviluppo con l'API Graph (anteprima)Develop against the Graph API (Preview)

Come si possono applicare le funzionalità dell'API Graph (anteprima) ad Azure Cosmos DB?How can I apply the functionality of Graph API (Preview) to Azure Cosmos DB?

Per applicare le funzionalità dell'API Graph (anteprima) è possibile usare una libreria di estensioni,You can use an extension library to apply the functionality of Graph API (Preview). denominata Microsoft Azure Graphs e disponibile in NuGet.This library is called Microsoft Azure Graphs, and it is available on NuGet.

È supportato il linguaggio per l'attraversamento di grafi Gremlin.It looks like you support the Gremlin graph traversal language. È prevista l'aggiunta di altre forme di query?Do you plan to add more forms of query?

Sì. È prevista in futuro l'aggiunta di altri meccanismi di query.Yes, we plan to add other mechanisms for query in the future.

Come si può usare la nuova offerta dell'API Graph (anteprima)?How can I use the new Graph API (Preview) offering?

Per iniziare, vedere la guida introduttiva all'API Graph.To get started, complete the Graph API quick-start article.

Sviluppare con l'API Apache Cassandra (anteprima)Develop with the Apache Cassandra API (preview)

Qual è la versione del protocollo supportata nell'anteprima privata?What is the protocol version supported in the private preview? È previsto il supporto per altri protocolli?Is there a plan to support other protocols?

L'API Apache Cassandra per Azure Cosmos DB supporta attualmente CQL versione 4.Apache Cassandra API for Azure Cosmos DB supports today CQL version 4. In caso di feedback sul supporto di altri protocolli, segnalarlo sul sito del feedback UserVoice o inviare un messaggio di posta elettronica all'indirizzo askcosmosdbcassandra@microsoft.com.If you have feedback about supporting other protocols, let us know via uservoice feedback or send an email to askcosmosdbcassandra@microsoft.com.

Perché la scelta di una velocità effettiva per una tabella rappresenta un requisito?Why is choosing a throughput for a table a requirement?

Azure Cosmos DB configura la velocità effettiva predefinita per il contenitore in base alla posizione in cui è stata creata la tabella, ovvero nel portale o in CQL.Azure Cosmos DB sets default throughput for your container based on where you create the table from - portal or CQL. Azure Cosmos DB offre garanzie di prestazioni e latenza, con limiti superiori nelle operazioni.Azure Cosmos DB provides guarantees for performance and latency, with upper bounds on operation. Questa garanzia è possibile quando il motore può applicare la governance nelle operazioni del tenant.This guarantee is possible when the engine can enforce governance on the tenant's operations. La configurazione della velocità effettiva assicura la velocità effettiva e la latenza garantite, perché la piattaforma riserva tale capacità e garantisce l'esito positivo delle operazioni.Setting throughput ensures that you get the guaranteed throughput and latency, because the platform reserves this capacity and guarantees operation success. È possibile modificare in modo flessibile la velocità effettiva per usufruire della stagionalità delle applicazioni e ridurre i costi.You can elastically change throughput to benefit from the seasonality of your application and save costs.

Il concetto di velocità effettiva è illustrato nell'articolo Unità richiesta in Azure Cosmos DB.The throughput concept is explained in the Request Units in Azure Cosmos DB article. La velocità effettiva per una tabella viene distribuita equamente tra le partizioni fisiche sottostanti.The throughput for a table is distributed across the underlying physical partitions equally.

Qual è la UR/s predefinita di una tabella creata tramite CQL?What is the default RU/s of table when created through CQL? In che modo la si può modificare, se necessario?What If I need to change it?

Azure Cosmos DB usa le unità richiesta al secondo (UR/s) come misura per fornire velocità effettiva.Azure Cosmos DB uses request units per second (RU/s) as a currency for providing throughput. Le tabelle create con CQL hanno 400 UR.Tables created through CQL have 400 RU. È possibile modificare le UR dal portale.You can change the RU from the portal.

CQLCQL

CREATE TABLE keyspaceName.tablename (user_id int PRIMARY KEY, lastname text) WITH cosmosdb_provisioned_throughput=1200

.NET.NET

int provisionedThroughput = 400;
var simpleStatement = new SimpleStatement($"CREATE TABLE {keyspaceName}.{tableName} (user_id int PRIMARY KEY, lastname text)");
var outgoingPayload = new Dictionary<string, byte[]>();
outgoingPayload["cosmosdb_provisioned_throughput"] = Encoding.UTF8.GetBytes(provisionedThroughput.ToString());
simpleStatement.SetOutgoingPayload(outgoingPayload); 

Cosa accade quando viene superata la velocità effettiva?What happens when throughput is exceeded?

Azure Cosmos DB offre garanzie di prestazioni e latenza, con limiti superiori nelle operazioni.Azure Cosmos DB provides guarantees for performance and latency, with upper bounds on operation. Questa garanzia è possibile quando il motore può applicare la governance nelle operazioni del tenant.This guarantee is possible when the engine can enforce governance on the tenant's operations. Ciò è possibile in base alla configurazione della velocità effettiva, che assicura la velocità effettiva e la latenza garantite, perché la piattaforma riserva tale capacità e garantisce l'esito positivo delle operazioni.This is possible based on setting the throughput, which ensures that you get the guaranteed throughput and latency, because platform reserves this capacity and guarantees operation success. Quando si supera questa capacità, viene visualizzato un messaggio di errore di overload a indicare che è stata superata la capacità.When you exceed this capacity you get overloaded error message indicating your capacity was exceeded. 0x1001 Overloaded: the request cannot be processed because "Request Rate is large" (0x1001 In overload: impossibile elaborare la richiesta, poiché "La frequenza delle richieste è troppo elevata").0x1001 Overloaded: the request cannot be processed because "Request Rate is large". A questo punto è essenziale esaminare le operazioni che, unitamente al loro volume, determinano questo problema.At this juncture it is essential to see what operations and their volume causes this issue. È possibile avere un'idea della capacità usata che supera la capacità fornita con le metriche nel portale.You can get an idea about consumed capacity exceeding the provisioned capacity with metrics on the portal. È poi necessario verificare che la capacità venga usata pressoché equamente tra tutte le partizioni sottostanti.Then you need to ensure capacity is consumed nearly equally across all underlying partitions. Se si nota che la maggior parte della velocità effettiva viene usata da una partizione, si è in presenza di un'asimmetria del carico di lavoro.If you see most of the throughput is consumed by one partition, you have skew of workload.

Sono disponibili metriche che indicano in che modo la velocità effettiva viene usata in intervalli di ore, giorni e sette giorni, tra le partizioni o in modo aggregato.Metrics are available that show you how throughput is used over hours, days, and per seven days, across partitions or in aggregate. Per altre informazioni, vedere Eseguire il monitoraggio e il debug con le metriche in Azure Cosmos DB.For more information, see Monitoring and debugging with metrics in Azure Cosmos DB.

I log di diagnostica sono illustrati nell'articolo Registrazione diagnostica di Azure Cosmos DB.Diagnostic logs are explained in the Azure Cosmos DB diagnostic logging article.

La chiave primaria corrisponde al concetto di chiave di partizione di Azure Cosmos DB?Does the primary key map to the partition key concept of Azure Cosmos DB?

Sì, la chiave di partizione viene usata per collocare l'entità nella posizione corretta.Yes, the partition key is used to place the entity in right location. In Azure Cosmos DB consente di individuare la partizione logica corretta archiviata in una partizione fisica.In Azure Cosmos DB it is used to find right logical partition that is stored on a physical partition. Il concetto di partizionamento è illustrato in dettaglio nell'articolo Partizionamento e ridimensionamento in Azure Cosmos DB.The partitioning concept is well explained in the Partition and scale in Azure Cosmos DB article. Il fulcro della questione è che a oggi una partizione logica non deve superare il limite di 10 GB.The essential take away here is that a logical partition should not exceed the 10 GB limit today.

Cosa accade se viene visualizzata una notifica di raggiungimento della quota che indica che la partizione è piena?What happens when I get a “quota full" notification indicating that a partition is full?

Azure Cosmos DB è un sistema basato su contratti di servizio che offre scalabilità illimitata, con garanzie di latenza, velocità effettiva, disponibilità e coerenza.Azure Cosmos DB is a SLA-based system that provides unlimited scale, with guarantees for latency, throughput, availability, and consistency. Anche l'API Cassandra consente l'archiviazione illimitata dei dati.It's Cassandra API too allows unlimited storage of data. Questo tipo di archiviazione illimitata si basa sulla scalabilità orizzontale dei dati usando il partizionamento come concetto chiave.This unlimited storage is based on horizontal scaleout of data using partitioning as the key concept. Il concetto di partizionamento è illustrato in dettaglio nell'articolo Partizionamento e ridimensionamento in Azure Cosmos DB.The partitioning concept is well explained in the Partition and scale in Azure Cosmos DB article.

È necessario rispettare il limite di 10 GB sul numero di entità o elementi per partizione logica.The 10-GB limit on the number of entities or items per logical partition you should adhere to. Per assicurare la scalabilità dell'applicazione, è consigliabile non creare una partizione critica archiviando tutte le informazioni in una partizione ed eseguendo query su di essa.To ensure that your application scales well, we recommend that you not create a hot partition by storing all information in one partition and querying it. Questo errore può verificarsi solo in presenza di dati asimmetrici, ovvero con un numero elevato di dati per una chiave di partizione, ad esempio più di 10 GB.This error can only come if you data is skewed - that is you have lot of data for one partition key - i.e., more than 10 GB. La distribuzione dei dati è disponibile nel portale di archiviazione.You can find the distribution of data using the storage portal. Un modo per correggere l'errore consiste nel ricreare la tabella e scegliere una chiave primaria (di partizione) granulare, che consente una migliore distribuzione dei dati.Way to fix this error is to recrete the table and choose a granular primary (partition key), which allows better distribution of data.

È possibile usare l'API Cassandra come archivio di valori/chiavi con milioni o miliardi di singole chiavi di partizione?Is it possible to use Cassandra API as key value store with millions or billions of individual partition keys?

Azure Cosmos DB può archiviare un numero illimitato di dati grazie alla scalabilità orizzontale di archiviazione,Azure Cosmos DB can store unlimited data by scaling out the storage. in modo indipendente dalla velocità effettiva.This is independent of the throughput. Sì, è comunque possibile usare l'API Cassandra per archiviare e recuperare chiavi e valori specificando la chiave primaria o di partizione corretta.Yes you can always just use Cassandra API to store and retrieve key/values by specifying right primary/partition key. Queste singole chiavi ottengono una specifica partizione logica e si trovano al di sopra della partizione fisica.These individual keys get their own logical partition and sit atop physical partition without issues.

È possibile creare più tabelle con l'API Apache Cassandra di Azure Cosmos DB?Is it possible to create multiple tables with Apache Cassandra API of Azure Cosmos DB?

Sì, è possibile creare più tabelle con l'API Apache Cassandra.Yes, it is possible to crete multiple tables with Apache Cassandra API. Ogni tabella viene trattata come una singola unità per velocità effettiva e archiviazione.Each of those tables is treated as unit for throughput and storage.

È possibile creare più tabelle in successione?Is it possible to create multiple tables in succession?

Azure Cosmos DB è un sistema basato su risorse per attività a livello di dati e di controllo.Azure Cosmos DB is resource governed system for both data and control plane activities. I contenitori come le raccolte e le tabelle sono entità di runtime sottoposte a provisioning per una determinata capacità di velocità effettiva.Containers like collections, tables are runtime entities which are provisioned for given throughput capacity. La creazione di questi contenitori in rapida successione non è un'attività prevista e potrebbe essere limitata.The creation of these containers in quick succession is not expected activity and throttled. In presenza di test che creano/eliminano tabelle immediatamente, provare a distanziarli.If you have tests which drop/create tables immediately - please try to space them out.

Qual è il numero massimo di tabelle che è possibile creare?What is maximum number of tables which can be created?

Non è previsto alcun limite fisico sul numero di tabelle. Inviare un messaggio di posta elettronica all'indirizzo askcosmosdbcassandra@microsoft.com se è necessario creare un numero elevato di tabelle con dimensione costante totale superiore a 10 TB, rispetto alle consuete decine o centinaia.There is no physical limit on number of tables, please send an email at askcosmosdbcassandra@microsoft.com if you have very large number of tables (where the total steady size exceeds 10 TB of data) that need to be created from usual 10s or 100s.

Qual è il numero massimo di keyspace che è possibile creare?What is the maximum # of keyspace which we can create?

Non è previsto alcun limite fisico sul numero di keyspace, in quanto sono contenitori di metadati. Inviare un messaggio di posta elettronica all'indirizzo askcosmosdbcassandra@microsoft.com in presenza di un numero elevato di keyspace.There is no physical limit on number of keyspaces as they are metadata containers, please send an email at askcosmosdbcassandra@microsoft.com if you have very large number of keyspaces for some reason.

È possibile inserire una quantità elevata di dati dopo l'avvio da una tabella normale?Is it possible to bring in lot of data after starting from normal table?

La capacità di archiviazione viene gestita automaticamente e aumenta con l'inserimento di dati aggiuntivi.The storage capacity is automatically managed and increases as you push in more data. È quindi possibile importare tranquillamente la quantità di dati necessaria senza la gestione e il provisioning dei nodi e così via.So you can confidently import as much data as you need without managing and provisioning nodes, etc.

È possibile fornire le impostazioni del file yaml per configurare il comportamento dell'API Apache Cassandra di Azure Cosmos DB?Is it possible to supply yaml file settings to configure Apache Casssandra API of Azure Cosmos DB behavior?

L'API Apache Cassandra di Azure Cosmos DB è un servizio di piattaforma.Apache Cassandra API of Azure Cosmos DB is a platform service. Fornisce compatibilità a livello di protocollo per l'esecuzione di operazioni.It provides protocol level compatibilty for executing operations. Nasconde la complessità della gestione, del monitoraggio e della configurazione.It hides away the complexity of management, monitoring and configuration. Gli utenti e gli sviluppatori non devono preoccuparsi di disponibilità, rimozioni definitive, cache delle chiavi, cache delle righe, filtri Bloom e di molte altre impostazioni.As a developer/user you do not need to worry about availability, tombstones, key cache, row cache, bloom filter and multitude of other settings. L'API Apache Cassandra di Azure Cosmos DB fornisce le prestazioni di lettura e di scrittura necessarie, senza l'overhead della configurazione e della gestione.Azure Cosmos DB's Apache Cassandra API focuses on providing read and write performance that you require without the overhead of configuration and management.

L'API Apache Cassandra per Azure Cosmos DB supporterà i comandi per aggiunta nodo/stato del cluster/stato del nodo?Will Apache Cassandra API for Azure Cosmos DB support node addition/cluster status/node status commands?

L'API Apache Cassandra è un servizio di piattaforma che semplifica la pianificazione della capacità e la risposta a richieste di elasticità per la velocità effettiva e le risorse di archiviazione.Apache Cassandra API is a platform service which makes capacity planning, responding to the elasticity demands for throughput & storage a breeze. Con Azure Cosmos DB è possibile effettuare il provisioning della velocità effettiva necessaria.With Azure Cosmos DB you provision throughput you need. È quindi possibile aumentare o ridurre il numero di unità ogni volta che risulta necessario durante la giornata, senza doversi preoccupare di aggiungere/eliminare nodi o gestirli.Then you can scale it up and down any number of times through the day without worrying about adding/deleting nodes or managing them. Non è quindi necessario usare alcuno strumento di gestione di nodi o cluster.This implies you do not need to use the node, cluster management tool too.

Che cosa accade alle diverse impostazioni di configurazione per la creazione del keyspace (semplice/rete)?What happens with respect to various config settings for keyspace creation like simple/network?

Azure Cosmos DB offre la distribuzione globale predefinita per motivi di disponibilità e di bassa latenza.Azure Cosmos DB provides global distribution out of the box for availability and low latency reasons. Non è necessario configurare repliche. Viene eseguito il commit durevole nel quorum di tutte le operazioni di scrittura in qualsiasi area in cui vengono scritti i dati, fornendo al tempo stesso garanzie relative alle prestazioni.You do not need to setup replicas etc. All writes are always durably quorum committed in a any region where you write while providing performance guarantees.

Che cosa accade alle diverse impostazioni per i metadati di tabella come i filtri Bloom, la memorizzazione nella cache, le modifiche di correzione delle operazioni di lettura, gc_grace e memtable_flush_period di compressione e così via?What happens with respect to various settings for table metadata like bloom filter, caching, read repair change, gc_grace, compression memtable_flush_period etc?

Azure Cosmos DB offre prestazioni per operazioni di lettura/scrittura e per velocità effettiva senza che sia necessario modificare le impostazioni di configurazione, evitando così il rischio di alterazioni accidentali.Azure Cosmos DB provides performance for reads/writes and throughput without need for touching any of the configuration settings and accidently manipulating them.

La Durata (TTL) è supportata per le tabelle di Cassandra?Is time-to-live (TTL) supported for Cassandra tables?

Sì, la Durata (TTL) è supportata.Yes, TTL is supported.

È possibile monitorare in anticipo lo stato dei nodi, lo stato delle repliche, gc e i parametri del sistema operativo con vari strumenti?Is it possible to monitor node status, replica status, gc, and OS parameters earlier with various tools? Cosa deve essere monitorato ora?What needs to be monitored now?

Azure Cosmos DB è un servizio di piattaforma che consente di incrementare la produttività, senza doversi preoccupare della gestione e del monitoraggio dell'infrastruttura.Azure Cosmos DB is a platform service that helps you increase productivity and not worry about managing and monitoring infrastructure. È sufficiente occuparsi della velocità effettiva disponibile nelle metriche del portale per individuare eventuali limitazioni delle richieste e aumentare o diminuire la velocità effettiva.You just need to take care of throughput which is available on portal metrics to find if you are getting throttled and increase or decrease that throughput. Monitorare i contratti di servizio.Monitor SLAs. Usare la metrica Usare i log di diagnostica.Use Metrics Use Diagnostic logs.

Quali SDK client possono essere usati con l'API Apache Cassandra di Azure Cosmos DB?Which client SDKs can work with Apache Cassandra API of Azure Cosmos DB?

In anteprima privata, per i programmi client sono stati usati i driver del client di Apache Cassandra SDK, che usano CQLv3.In private preview Apache Cassandra SDK's client drivers which use CQLv3 were used for client programs. In caso di uso di altri driver o se si verificano problemi, inviare un messaggio di posta elettronica all'indirizzo askcosmosdbcassandra@microsoft.com.If you have other drivers that you use or if you are facing issues, send mail to askcosmosdbcassandra@microsoft.com.

La chiave di partizione composta è supportata?Is composite partition key supported?

Sì, è possibile usare la sintassi normale per creare una chiave di partizione composta.Yes, you can use regular syntax to create composite partition key.

È possibile usare il caricatore sstable per il caricamento di dati?Can I use sstable loader for data loading?

No, durante l'anteprima il caricatore sstable non è supportato.No, during preview sstable loader is not supported.

È possibile associare un cluster Cassandra locale all'API Apache Cassandra di Azure Cosmos DB?Can an on-premises cassandra cluster be paired with Azure Cosmos DB's Apache Cassandra API?

Attualmente Azure Cosmos DB offre un'esperienza ottimizzata per l'ambiente cloud, senza l'overhead delle operazioni.At present Azure Cosmos DB has an optimized experience for cloud environment without overhead of operations. Se è necessaria l'associazione, inviare un messaggio di posta elettronica all'indirizzo askcosmosdbcassandra@microsoft.com con una descrizione dello scenario.If you require pairing, please send mail to askcosmosdbcassandra@microsoft.com with a description of your scenario.

L'API Cassandra fornisce backup completi?Does Cassandra API provide full backups?

Azure Cosmos DB fornisce attualmente due backup completi gratuiti, creati a intervalli di quattro ore, in tutte le API.Azure Cosmos DB provides two free full backups taken at four hours interval today across all APIs. Non è quindi necessario configurare alcuna pianificazione dei backup. Per modificare la conservazione e la frequenza dei backup, inviare un messaggio di posta elettronica all'indirizzo askcosmosdbcassandra@microsoft.com o aprire un caso di supporto.This ensures you do not need to setup a backup schedule etc. If you want to modify retention and frequency, send an email to askcosmosdbcassandra@microsoft.com or raise a support case. Informazioni sulla funzionalità di backup sono disponibili nell'articolo Backup online automatico e ripristino con Azure Cosmos DB.Information about backup capability is provided in the Automatic online backup and restore with Azure Cosmos DB article.

Come viene gestito il failover dall'account dell'API Cassandra se un'area diventa inattiva?How does the Cassandra API account handle failover if a region goes down?

L'API Cassandra di Azure Cosmos DB sfrutta la piattaforma distribuita a livello globale di Azure Cosmos DB.The Azure Cosmos DB Cassandra API borrows from the globally distributed platform of Azure Cosmos DB. Affinché l'applicazione possa tollerare i tempi di inattività del data center, abilitare almeno un'altra area per l'account nel portale di Azure Cosmos DB, come illustrato nell'articolo relativo allo sviluppo con account Azure Cosmos DB tra più aree.To ensure that your application can tolerate datacenter downtime, enable at least one more region for the account in the Azure Cosmos DB portal Developing with multi-region Azure Cosmos DB accounts. Si può impostare la priorità dell'area usando il portale. Vedere l'articolo relativo allo sviluppo con account Azure Cosmos DB tra più aree.You can set the priority of the region by using the portal Developing with multi-region Azure Cosmos DB accounts.

È possibile aggiungere il numero di aree desiderato per l'account e controllare in quale potrà essere effettuato il failover specificando una priorità di failover.You can add as many regions as you want for the account and control where it can fail over to by providing a failover priority. Per usare il database, è necessario includere anche un'applicazione.To use the database, you need to provide an application there too. Nel corso di questa operazione, i clienti non riscontrano tempi di inattività.When you do so, your customers will not experience downtime.

L'API Apache Cassandra indicizza tutti gli attributi di un'entità per impostazione predefinita?Does the Apache Cassandra API index all attributes of an entity by default?

Sì, tutti gli attributi vengono indicizzati per impostazione predefinita da Azure Cosmos DB.Yes, all attributes of an entity are indexed by default by Azure Cosmos DB. Per altre informazioni, vedere l'articolo relativo ai criteri di indicizzazione di Azure Cosmos DB.For more information, see Azure Cosmos DB: Indexing policies. Si ottengono sempre i vantaggi delle prestazioni garantite, con indicizzazione coerente e scritture con commit nel quorum durevole.You get benefits of guaranteed performance with consistent indexing and durable quorum committed writes always.

Per soddisfare le query è quindi necessario creare più indici?Does this mean I do not have to create multiple indexes to satisfy the queries?

Sì. Azure Cosmos DB offre l'indicizzazione automatica di tutti gli attributi senza definizione di schema.Yes, Azure Cosmos DB provides automatic indexing of all attributes without any schema definition. Questa automazione consente agli sviluppatori di concentrarsi sull'applicazione anziché sulla creazione e sulla gestione degli indici.This automation frees developers to focus on the application rather than on index creation and management. Per altre informazioni, vedere l'articolo relativo ai criteri di indicizzazione di Azure Cosmos DB.For more information, see Azure Cosmos DB: Indexing policies.

È possibile usare l'SDK della nuova API Cassandra in locale con l'emulatore?Can I use the new Cassandra API SDK locally with the emulator?

Il supporto di questa funzionalità è previsto in futuro.We plan to support this capability in future.

Come piattaforma, Azure Cosmos DB offre numerose funzionalità, tra cui il feed di modifiche.Azure Cosmos DB as a platform seems to have lot of capabilities, such as changefeed and other functionality. Queste funzionalità verranno aggiunte all'API Cassandra?Will these capabilities be added to the Cassandra API?

L'API Apache Cassandra fornisce le stesse funzionalità CQL di Apache Cassandra.The Apache Cassandra API provides the same CQL functionality as Apache Cassandra. In futuro prevediamo la possibilità di includere il supporto per varie funzionalità.We do plan to look into feasibility of supporting various capabilities in future.

Attualmente la funzionalità x dell'API Cassandra standard non funziona: dove è possibile fornire feedback?Feature x of regular Cassandra API is not working as today, where can the feedback be provided?

Fornire commenti e suggerimenti sul sito del feedback UserVoice.Provide feedback via uservoice feedback.

Domande di clienti di DocumentDBQuestions from DocumentDB customers

Perché viene eseguito il passaggio ad Azure Cosmos DB?Why are you moving to Azure Cosmos DB?

Azure Cosmos DB è il prossimo passo decisivo nell'ambito dei database cloud distribuiti a livello globale su larga scala.Azure Cosmos DB is the next big leap in globally distributed, at-scale cloud databases. I clienti di DocumentDB hanno ora accesso al sistema e alle funzionalità all'avanguardia offerti da Azure Cosmos DB.As a DocumentDB customer, you now have access to the breakthrough system and capabilities offered by Azure Cosmos DB.

Azure Cosmos DB è stato introdotto come "progetto Florence" nel 2010 per far fronte ai problemi critici affrontati dagli sviluppatori nella creazione di applicazioni su larga scala all'interno di Microsoft.Azure Cosmos DB started as “Project Florence” in 2010 to address the pain points faced by developers in building large-scale applications inside Microsoft. Dato che i problemi relativi alla creazione di app distribuite a livello globale non sono stati riscontrati solo da Microsoft, nel 2015 è stata resa disponibile per gli sviluppatori di Azure la prima generazione di questa tecnologia, ovvero Azure DocumentDB.The challenges of building globally distributed apps are not unique to Microsoft, so we made the first generation of this technology available in 2015 to Azure developers in the form of Azure DocumentDB.

Da quel momento sono state aggiunte nuove importanti funzionalità.Since that time, we’ve added new features and introduced significant new capabilities. Il risultato è Azure Cosmos DB.Azure Cosmos DB is the result. Nell'ambito di questo rilascio, i clienti di DocumentDB, con i relativi dati, diventano in modo automatico e trasparente clienti di Azure Cosmos DB.As a part of this release, DocumentDB customers, with their data, automatically and seamlessly become Azure Cosmos DB customers. Queste funzionalità riguardano il motore di database principale, ma anche distribuzione globale, scalabilità elastica e contratti di servizio completi, leader del settore.These capabilities are in the areas of the core database engine, as well as global distribution, elastic scalability, and industry-leading, comprehensive SLAs. In particolare, il motore di database di Azure Cosmos DB è stato sviluppato per ottenere un mapping efficiente di tutti i più comuni modelli di dati, sistemi di tipi e API al modello di dati sottostante di Azure Cosmos DB.Specifically, we have evolved the Azure Cosmos DB database engine to efficiently map all popular data models, type systems, and APIs to the underlying data model of Azure Cosmos DB.

Il risultato di questo miglioramento più evidente per gli sviluppatori è attualmente il nuovo supporto per le API di archiviazione tabelle e Gremlin.The current developer-facing manifestation of this work is the new support for Gremlin and Table storage APIs. Questo, però, è solo l'inizio.And this is just the beginning. È prevista l'aggiunta nel corso del tempo di altre API popolari e modelli di dati più recenti con ulteriori miglioramenti in termini di prestazioni e di archiviazione su scala globale.We plan to add other popular APIs and newer data models over time, with more advances in performance and storage at global scale.

È importante sottolineare che il dialetto SQL di DocumentDB è sempre stato solo una delle tante API che possono essere supportate da Azure Cosmos DB sottostante.It is important to point out that the DocumentDB SQL dialect has always been just one of the many APIs that the underlying Azure Cosmos DB can support. Per gli sviluppatori che usano un servizio completamente gestito come Azure Cosmos DB, l'unica interfaccia per il servizio sono le API esposte dal servizio.For developers who use a fully managed service such as Azure Cosmos DB, the only interface to the service is the APIs that are exposed by the service. Non cambia nulla per i clienti esistenti di DocumentDB.Nothing really changes for existing DocumentDB customers. In Azure Cosmos DB è disponibile esattamente la stessa API SQL offerta da DocumentDB.In Azure Cosmos DB, you get exactly the same SQL API that DocumentDB offers. Ora (e in futuro) è possibile accedere ad altre funzionalità prima non accessibili.And now (and in the future), you can access other previously inaccessible capabilities

Un altro risultato evidente dei miglioramenti apportati è l'ampia base per la scalabilità globale ed elastica della velocità effettiva e dello spazio di archiviazione,Another manifestation of our continued work is the extended foundation for global and elastic scalability of throughput and storage. Sono stati apportati diversi miglioramenti al sottosistema di distribuzione globale.We have made several foundational enhancements to the global distribution subsystem. Una delle molte funzionalità per gli sviluppatori è il modello di coerenza del prefisso, che porta a cinque il numero di modelli di coerenza ben definiti.One of the many such developer-facing features is the Consistent Prefix consistency model, which makes a total five well-defined consistency models. Diverse funzionalità ancora più interessanti verranno rilasciate non appena saranno definitive.We will release many more interesting capabilities as they mature.

Che cosa è necessario fare per assicurarsi che le risorse di DocumentDB continuino a essere eseguite in Azure Cosmos DB?What do I need to do to ensure that my DocumentDB resources continue to run on Azure Cosmos DB?

In questo caso non sono necessarie modifiche.You don't need to make any changes all. Le risorse di DocumentDB sono ora risorse di Azure Cosmos DB e non si sono verificate interruzioni del servizio al momento del passaggio.Your DocumentDB resources are now Azure Cosmos DB resources, and there was no interruption in the service when this move occurred.

Quali modifiche è necessario apportare all'app perché funzioni con Azure Cosmos DB?What changes do I need to make for my app to work with Azure Cosmos DB?

Non è necessario apportare alcuna modifica.There are no changes to make. Classi, spazi dei nomi e nomi di pacchetti NuGet non sono stati modificati.Classes, namespaces, and NuGet package names have not changed. Come sempre, è consigliabile mantenere aggiornati gli SDK per poter sfruttare i vantaggi delle funzionalità e dei miglioramenti più recenti.As always, we recommend that you keep your SDKs up to date to take advantage of the latest features and improvements.

Che cosa è cambiato nel portale di Azure?What's changed in the Azure portal?

DocumentDB non è più visualizzato nel portale come servizio di Azure.DocumentDB no longer appears in the portal as an Azure service. Al suo posto si trova una nuova icona di Azure Cosmos DB, come illustrato nell'immagine seguente.In its place is a new Azure Cosmos DB icon, as shown in the following image. Tutte le raccolte sono disponibili come prima ed è ancora possibile ridimensionare la velocità effettiva, modificare i livelli di coerenza e monitorare i contratti di servizio.All your collections are available, as they were before, and you can still scale throughput, change consistency levels, and monitor SLAs. Sono state migliorate le funzionalità di Esplora dati (anteprima).The capabilities of Data Explorer (Preview) have been enhanced. È ora possibile visualizzare e modificare i documenti, creare ed eseguire query e usare stored procedure, trigger e funzioni definite dall'utente da una sola pagina, come illustrato nell'immagine seguente:You can now view and edit documents, create and run queries, and work with stored procedures, triggers, and UDF from one page, as shown in the following image:

Pagina Raccolte di Azure Cosmos DB

I prezzi sono stati modificati?Are there changes to pricing?

No, il costo per eseguire l'app in Azure Cosmos DB è lo stesso di prima.No, the cost of running your app on Azure Cosmos DB is the same as it was before.

I contratti di servizio sono stati modificati?Are there changes to the SLAs?

No, i contratti di servizio per disponibilità, coerenza, latenza e velocità effettiva non sono stati modificati e vengono ancora visualizzati nel portale.No, the SLAs for availability, consistency, latency, and throughput are unchanged and are still displayed in the portal. Per altre informazioni, vedere Contratto di Servizio per Azure Cosmos DB.For more information, see SLA for Azure Cosmos DB.

App elenco attività con dati di esempio