Questions fréquentes sur les différentes API dans Azure Cosmos DBFrequently asked questions about different APIs in Azure Cosmos DB

Quels sont les cas d’utilisation courants d’Azure Cosmos DB ?What are the typical use cases for Azure Cosmos DB?

Azure Cosmos DB est un choix judicieux pour les nouvelles applications web, mobiles, de jeu et IoT où une mise à l’échelle automatique, des performances prévisibles, des temps de réponse rapides de l’ordre d’une milliseconde et la capacité à exécuter des requêtes sur des données sans schéma sont importants.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 permet un développement rapide et prend en charge l’itération continue des modèles de données d’application.Azure Cosmos DB lends itself to rapid development and supporting the continuous iteration of application data models. Les applications qui gèrent du contenu et des données générés par l’utilisateur sont des cas d’utilisation courants pour Azure Cosmos DB.Applications that manage user-generated content and data are common use cases for Azure Cosmos DB.

Comment Azure Cosmos DB offre-t-il des performances prévisibles ?How does Azure Cosmos DB offer predictable performance?

Dans Azure Cosmos DB, la mesure du débit est exprimée en unités de requête (RU).A request unit (RU) is the measure of throughput in Azure Cosmos DB. Un débit 1RU correspond au débit d’obtention d’un document de 1 Ko.A 1RU throughput corresponds to the throughput of the GET of a 1-KB document. Chaque opération dans Azure Cosmos DB, y compris les lectures, les écritures, les requêtes SQL et les exécutions de procédures stockées, comporte une valeur de RU déterministe basée sur le débit nécessaire à l’exécution de l’opération.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. Au lieu de penser à l’UC, à l’E/S et à la mémoire, ainsi qu’à la façon dont ces éléments affectent le débit de votre application, vous pouvez penser en termes de mesure de RU unique.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.

Vous pouvez configurer chaque conteneur Azure Cosmos avec un débit approvisionné en termes de RU de débit par seconde.You can configure each Azure Cosmos container with provisioned throughput in terms of RUs of throughput per second. Pour les applications de toute échelle, vous pouvez évaluer les requêtes individuelles pour mesurer leur valeur de RU, et approvisionner un conteneur pour gérer la totalité des unités de requête sur l’ensemble des requêtes.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. Vous pouvez également mettre à l’échelle le débit de votre conteneur à mesure de l’évolution des besoins de votre application.You can also scale up or scale down your container's throughput as the needs of your application evolve. Pour plus d’informations sur les unités de demande et pour vous aider à déterminer les besoins de votre conteneur, essayez le calculatrice de débit.For more information about request units and for help with determining your container needs, try the throughput calculator.

Comment Azure Cosmos DB prend-il en charge différents modèles de données comme clé/valeur, en colonnes, document et graphe ?How does Azure Cosmos DB support various data models such as key/value, columnar, document, and graph?

Les modèles de données clé/valeur (table), en colonnes, document et graphe sont tous pris en charge de manière native en raison de la conception ARS (atomes, enregistrements et séquences) sur laquelle repose 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. Les atomes, enregistrements et séquences peuvent facilement être mappés et projetés vers différents modèles de données.Atoms, records, and sequences can be easily mapped and projected to various data models. Les API pour certains modèles sont déjà disponibles (SQL, MongoDB, Table et Gremlin), tandis que d’autres API propres à des modèles de données supplémentaires seront disponibles plus tard.The APIs for a subset of models are available right now (SQL, MongoDB, Table, and Gremlin) and others specific to additional data models will be available in the future.

Azure Cosmos DB a un moteur d’indexation indépendant du point de vue du schéma capable d’indexer automatiquement toutes les données qu’il reçoit sans nécessiter de schéma ou d’index secondaire de la part du développeur.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. Le moteur s’appuie sur un ensemble de dispositions d’index logiques (inversée, en colonnes, arborescence) qui découplent la disposition de stockage des sous-systèmes de traitement de requêtes et d’index.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 peut également prendre en charge un ensemble de protocoles de transmission et d’API de manière extensible, et les traduire efficacement vers le modèle de données principal (1) et les dispositions d’index logiques (2), ce qui en fait une solution unique capable de prendre en charge plus d’un modèle de données en mode natif.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 more than one data model natively.

Azure Cosmos DB est-il conforme à la loi HIPAA ?Is Azure Cosmos DB HIPAA compliant?

Oui, Azure Cosmos DB est conforme à la loi HIPAA.Yes, Azure Cosmos DB is HIPAA-compliant. HIPAA établit les conditions requises pour l’utilisation, la divulgation et la protection des informations de santé identifiables de façon individuelle.HIPAA establishes requirements for the use, disclosure, and safeguarding of individually identifiable health information. Pour plus d’informations, consultez le Centre de gestion de la confidentialité de Microsoft.For more information, see the Microsoft Trust Center.

Quelles sont les limites de stockage d’Azure Cosmos DB ?What are the storage limits of Azure Cosmos DB?

Il n’existe aucune limite à la quantité totale de données qu’un conteneur peut stocker dans Azure Cosmos DB.There's no limit to the total amount of data that a container can store in Azure Cosmos DB.

Quelles sont les limites de débit d’Azure Cosmos DB ?What are the throughput limits of Azure Cosmos DB?

Il n’existe aucune limite au débit total qu’un conteneur peut prendre en charge dans Azure Cosmos DB.There's no limit to the total amount of throughput that a container can support in Azure Cosmos DB. L’idée principale est de distribuer votre charge de travail à peu près uniformément entre un nombre suffisant de clés de partition.The key idea is to distribute your workload roughly evenly among a sufficiently large number of partition keys.

Les modes de connectivité directe et de passerelle sont-ils chiffrés ?Are Direct and Gateway connectivity modes encrypted?

Oui, les deux modes sont toujours entièrement chiffrés.Yes both modes are always fully encrypted.

Combien coûte Azure Cosmos DB ?How much does Azure Cosmos DB cost?

Pour plus d’informations, voir Tarification d’Azure Cosmos DB.For details, refer to the Azure Cosmos DB pricing details page. Les frais d’utilisation d’Azure Cosmos DB sont déterminés par le nombre de conteneurs approvisionnés, le nombre d’heures durant lequel les conteneurs ont été en ligne et le débit approvisionné pour chaque conteneur.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.

Un compte gratuit est-il disponible ?Is a free account available?

Oui, vous pouvez bénéficier d’un compte à durée limitée sans frais ni engagement.Yes, you can sign up for a time-limited account at no charge, with no commitment. Pour y souscrire, accédez à la page Essayez gratuitement Azure Cosmos DB ou consultez les questions fréquentes (FAQ) sur Azure Cosmos DB pour en savoir plus.To sign up, visit Try Azure Cosmos DB for free or read more in the Try Azure Cosmos DB FAQ.

Si vous débutez avec Azure, vous pouvez vous inscrire pour bénéficier d’un compte Azure gratuit, qui vous donne 30 jours et un crédit pour essayer tous les services Azure.If you're new to Azure, you can sign up for an Azure free account, which gives you 30 days and a credit to try all the Azure services. Si vous avez un abonnement Visual Studio, vous pouvez aussi bénéficier de crédits Azure gratuits à utiliser sur n’importe quel service Azure.If you have a Visual Studio subscription, you're also eligible for free Azure credits to use on any Azure service.

Vous pouvez également utiliser l’émulateur Azure Cosmos DB pour développer et tester votre application localement, sans créer d’abonnement Azure et sans frais.You can also use the Azure Cosmos DB Emulator to develop and test your application locally for free, without creating an Azure subscription. Lorsque vous êtes satisfait du fonctionnement de votre application dans l’émulateur Azure Cosmos DB, vous pouvez commencer à utiliser un compte Azure Cosmos DB dans le 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.

Comment puis-je obtenir une aide supplémentaire avec Azure Cosmos DB ?How can I get additional help with Azure Cosmos DB?

Pour poser une question technique, connectez-vous à l’un de ces forums de questions-réponses :To ask a technical question, you can post to one of these two question and answer forums:

Pour demander de nouvelles fonctionnalités, faites une nouvelle demande sur User voice.To request new features, create a new request on User voice.

Pour résoudre un problème relatif à votre compte, enregistrez une demande de support sur le portail Azure.To fix an issue with your account, file a support request in the Azure portal.

Vous pouvez soumettre d’autres questions à l’équipe askcosmosdb@microsoft.com. Cette adresse n’est pas un alias pour le support technique.Other questions can be submitted to the team at askcosmosdb@microsoft.com; however this isn't a technical support alias.

Souscrire à l’offre Essayez gratuitement Azure Cosmos DBTry Azure Cosmos DB subscriptions

Vous pouvez désormais profiter pendant une durée limitée de l’expérience Azure Cosmos DB, sans abonnement, libre de frais et d’engagement.You can now enjoy a time-limited Azure Cosmos DB experience without a subscription, free of charge and commitments. Pour souscrire à l’offre Essayez gratuitement Azure Cosmos DB, accédez à la page Essayez gratuitement Azure Cosmos DB.To sign up for a Try Azure Cosmos DB subscription, go to Try Azure Cosmos DB for free. Cette souscription est indépendante de l’offre Créez votre compte Azure gratuit et peut être couplée à celle-ci ou à un abonnement Azure payant.This subscription is separate from the Azure Free Trial, and can be used along with an Azure Free Trial or an Azure paid subscription.

Les souscriptions à l’offre Essayez gratuitement Azure Cosmos DB figurent dans le portail Azure aux côtés des autres abonnements associés à votre ID utilisateur.Try Azure Cosmos DB subscriptions appear in the Azure portal next other subscriptions associated with your user ID.

Les souscriptions à l’offre Essayez gratuitement Azure Cosmos DB obéissent aux conditions suivantes :The following conditions apply to Try Azure Cosmos DB subscriptions:

  • Un conteneur approvisionné débit par abonnement pour les comptes SQL, les API Gremlin et Table.One throughput provisioned container per subscription for SQL, Gremlin API, and Table accounts.
  • Jusqu'à trois débit provisionné collections par abonnement pour les comptes MongoDB.Up to three throughput provisioned collections per subscription for MongoDB accounts.
  • Un base de données configuré débit par abonnement.One throughput provisioned database per subscription. Bases de données de débit approvisionné peuvent contenir n’importe quel nombre de conteneurs à l’intérieur.Throughput provisioned databases can contain any number of containers inside.
  • 10 Go de capacité de stockage.10-GB storage capacity.
  • La réplication globale est disponible dans les régions Azure suivantes : USA Centre, Europe Nord et Asie Sud-EstGlobal replication is available in the following Azure regions: Central US, North Europe, and Southeast Asia
  • Débit maximal de 5 K ur/s lors de l’approvisionnement au niveau du conteneur.Maximum throughput of 5 K RU/s when provisioned at the container level.
  • Débit maximal de 20 K ur/s lors de l’approvisionnement au niveau de la base de données.Maximum throughput of 20 K RU/s when provisioned at the database level.
  • Les abonnements expirent au bout de 30 jours et peuvent être étendus à un maximum de 31 jours au total.Subscriptions expire after 30 days, and can be extended to a maximum of 31 days total.
  • Il n’est pas possible de créer des tickets de support Azure pour les comptes d’évaluation d’Azure Cosmos DB ; cependant, les abonnés titulaires de plans de support actifs peuvent bénéficier du support.Azure support tickets can't be created for Try Azure Cosmos DB accounts; however, support is provided for subscribers with existing support plans.

Configurer Azure Cosmos DBSet up Azure Cosmos DB

Comment s’inscrire pour Azure Cosmos DB ?How do I sign up for Azure Cosmos DB?

Azure Cosmos DB est disponible dans le portail Azure.Azure Cosmos DB is available in the Azure portal. Tout d’abord, souscrivez un abonnement Azure.First, sign up for an Azure subscription. Une fois que vous êtes inscrit, vous pouvez ajouter un compte Azure Cosmos DB à votre abonnement Azure.After you've signed up, you can add an Azure Cosmos DB account to your Azure subscription.

Qu'est-ce qu’une clé principale ?What is a master key?

Une clé principale est un jeton de sécurité permettant d'accéder à toutes les ressources d'un compte.A master key is a security token to access all resources for an account. Les personnes disposant de cette clé ont un accès en lecture et en écriture à toutes les ressources du compte de la base de données.Individuals with the key have read and write access to all resources in the database account. Soyez prudent lorsque vous distribuez des clés principales.Use caution when you distribute master keys. La clé principale primaire et la clé principale secondaire sont disponibles dans le panneau Clés du portail Azure.The primary master key and secondary master key are available on the Keys blade of the Azure portal. Pour plus d’informations sur les clés, consultez la rubrique Affichage, copie et régénération de clés d’accès.For more information about keys, see View, copy, and regenerate access keys.

Quelles sont les régions configurables pour PreferredLocations ?What are the regions that PreferredLocations can be set to?

La valeur de PreferredLocations peut être définie sur toute région Azure dans laquelle Cosmos DB est disponible.The PreferredLocations value can be set to any of the Azure regions in which Cosmos DB is available. Pour obtenir la liste des régions disponibles, voir Régions Azure.For a list of available regions, see Azure regions.

Y a-t-il quelque chose que je dois savoir concernant la distribution de données à travers le monde via les centres de données Azure ?Is there anything I should be aware of when distributing data across the world via the Azure datacenters?

Azure Cosmos DB est présent dans toutes les régions Azure, comme l’indique la page Régions Azure.Azure Cosmos DB is present across all Azure regions, as specified on the Azure regions page. Comme il s’agit du service principal, chaque nouveau centre de données a une présence Azure Cosmos DB.Because it's the core service, every new datacenter has an Azure Cosmos DB presence.

Lorsque vous définissez une région, n’oubliez pas qu’Azure Cosmos DB respecte les clouds souverains et du secteur public.When you set a region, remember that Azure Cosmos DB respects sovereign and government clouds. Autrement dit, si vous créez un compte dans une région souveraine, vous ne pouvez pas répliquer en dehors de cette région souveraine.That is, if you create an account in a sovereign region, you can't replicate out of that sovereign region. De même, vous ne pouvez pas activer la réplication dans d’autres emplacements souverains à partir d’un compte externe.Similarly, you can't enable replication into other sovereign locations from an outside account.

Est-il possible de passer du provisionnement de débit au niveau du conteneur au provisionnement de débit au niveau de la base de données ?Is it possible to switch from container level throughput provisioning to database level throughput provisioning? Et inversement ?Or vice versa

Le provisionnement de débit au niveau du conteneur et de la base de données constituent des offres distinctes, et tout changement de l’un vers l’autre nécessite la migration de données de la source vers la destination.Container and database level throughput provisioning are separate offerings and switching between either of these require migrating data from source to destination. Cela signifie donc que vous devez créer une base de données ou une collection, puis migrer les données avec la bibliothèque de l’exécuteur en bloc ou Azure Data Factory.Which means you need to create a new database or a new collection and then migrate data by using bulk executor library or Azure Data Factory.

Azure CosmosDB prend-il en charge l’analyse des séries chronologiques ?Does Azure CosmosDB support time series analysis?

Oui, Azure CosmosDB prend en charge l’analyse des séries chronologiques. Voici un exemple de modèle de série chronologique.Yes Azure CosmosDB supports time series analysis, here is a sample for time series pattern. Cet exemple montre comment utiliser des flux de modification pour créer des affichages agrégés sur les données de série chronologique.This sample shows how to use change feed to build aggregated views over time series data. Vous pouvez étendre cette approche à l’aide de Spark Streaming ou d’un autre processeur de données de flux.You can extend this approach by using spark streaming or another stream data processor.

API SQLSQL API

Comment commencer à développer par rapport l’API SQL ?How do I start developing against the SQL API?

Vous devez d’abord souscrire un abonnement Microsoft Azure.First you must sign up for an Azure subscription. Après avoir souscrit un abonnement Microsoft Azure, vous pouvez ajouter un conteneur d’API SQL à votre abonnement Azure.Once you sign up for an Azure subscription, you can add a SQL API container to your Azure subscription. Pour savoir comment ajouter un compte Azure Cosmos DB, consultez Créer un compte de base de données Azure Cosmos DB.For instructions on adding an Azure Cosmos DB account, see Create an Azure Cosmos DB database account.

Kits de développement logiciel (SDK) sont disponibles pour .NET, Python, Node.js, JavaScript et Java.SDKs are available for .NET, Python, Node.js, JavaScript, and Java. Les développeurs peuvent également utiliser les API HTTP RESTful pour interagir avec les ressources Azure Cosmos DB sur différentes plateformes et dans de nombreux langages.Developers can also use the RESTful HTTP APIs to interact with Azure Cosmos DB resources from various platforms and languages.

Puis-je accéder à certains exemples prêts à l’emploi pour gagner du temps ?Can I access some ready-made samples to get a head start?

Des exemples pour les SDK .NET, Java, Node.js et Python de l’API SQL sont disponibles sur GitHub.Samples for the SQL API .NET, Java, Node.js, and Python SDKs are available on GitHub.

La base de données de l’API SQL prend-elle en charge les données sans schéma ?Does the SQL API database support schema-free data?

Oui, l’API SQL permet aux applications de stocker des documents JSON arbitraires sans définition ou conseil de schéma.Yes, the SQL API allows applications to store arbitrary JSON documents without schema definitions or hints. Les données peuvent être interrogées immédiatement via l’interface de requête SQL d’Azure Cosmos DB.Data is immediately available for query through the Azure Cosmos DB SQL query interface.

L’API SQL prend-elle en charge les transactions ACID ?Does the SQL API support ACID transactions?

Oui, l’API SQL prend en charge les transactions entre documents exprimées sous forme de procédures stockées et de déclencheurs JavaScript.Yes, the SQL API supports cross-document transactions expressed as JavaScript-stored procedures and triggers. Les transactions sont étendues à une seule partition au sein de chaque conteneur, et exécutées en mode « Tout ou rien » avec des sémantiques ACID, isolément d’autres codes et requêtes utilisateur s’exécutant simultanément.Transactions are scoped to a single partition within each container and executed with ACID semantics as "all or nothing," isolated from other concurrently executing code and user requests. Si des exceptions surviennent lors de l’exécution du code d’application JavaScript côté serveur, la transaction entière est annulée.If exceptions are thrown through the server-side execution of JavaScript application code, the entire transaction is rolled back.

Qu’est-ce qu’un conteneur ?What is a container?

Un conteneur est un groupe de documents accompagnés de leur logique d’application JavaScript.A container is a group of documents and their associated JavaScript application logic. Un conteneur est une entité facturable, où le coût est déterminé par le débit et le stockage utilisé.A container is a billable entity, where the cost is determined by the throughput and used storage. Des conteneurs peuvent s’étendre à un ou plusieurs serveurs ou partitions, et peuvent être mis à l’échelle pour gérer des volumes de stockage ou de débit pratiquement illimités.Containers can span one or more partitions or servers and can scale to handle practically unlimited volumes of storage or throughput.

  • Pour les comptes d’API SQL et les comptes d’API Azure Cosmos DB pour MongoDB, les conteneurs sont mappés vers des collections.For SQL API and Cosmos DB's API for MongoDB accounts, a container maps to a Collection.
  • Pour les comptes d’API Cassandra et Table, les conteneurs sont mappés vers des tables.For Cassandra and Table API accounts, a container maps to a Table.
  • Pour les comptes d’API Gremlin, les conteneurs sont mappés vers des graphes.For Gremlin API accounts, a container maps to a Graph.

Les conteneurs constituent également les entités de facturation d’Azure Cosmos DB.Containers are also the billing entities for Azure Cosmos DB. Chaque conteneur est facturé à l’heure, sur la base du débit provisionné et de l’espace de stockage utilisé.Each container is billed hourly, based on the provisioned throughput and used storage space. Pour plus d’informations, consultez la Tarification Azure Cosmos DB.For more information, see Azure Cosmos DB Pricing.

Comment créer une base de données ?How do I create a database?

Vous pouvez créer des bases de données à l’aide du portail Azure comme décrit dans Ajouter une collection, de l’un des Kits de développement logiciel (SDK) Azure Cosmos DB ou d’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.

Comment configurer des utilisateurs et des autorisations ?How do I set up users and permissions?

Vous pouvez créer des utilisateurs et des autorisations à l’aide de l’un des SDK d’API Cosmos DB ou des API REST.You can create users and permissions by using one of the Cosmos DB API SDKs or the REST APIs.

L’API SQL prend-elle en charge SQL ?Does the SQL API support SQL?

Le langage de requête SQL pris en charge par les comptes d’API SQL est un sous-ensemble amélioré des fonctionnalités de requête prises en charge par SQL Server.The SQL query language supported by SQL API accounts is an enhanced subset of the query functionality that's supported by SQL Server. Le langage de requête SQL d’Azure Cosmos DB fournit des opérateurs hiérarchiques et relationnels enrichis ainsi qu’une extensibilité par le biais de fonctions JavaScript définies par l’utilisateur.The Azure Cosmos DB SQL query language provides rich hierarchical and relational operators and extensibility via JavaScript-based, user-defined functions (UDFs). La grammaire JSON permet de modéliser des documents JSON en tant qu’arborescences comprenant des nœuds étiquetés qui sont utilisés par les techniques d’indexation automatique et le langage de requête SQL d’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. Pour plus d’informations sur l’utilisation de la grammaire SQL, consultez l’article Requêtes SQL.For information about using SQL grammar, see the SQL Query article.

L’API SQL prend-elle en charge les fonctions d’agrégation SQL ?Does the SQL API support SQL aggregation functions?

L’API SQL prend en charge l’agrégation à faible latence à n’importe quelle échelle par l’intermédiaire des fonctions d’agrégation COUNT, MIN, MAX, AVG et SUM par le biais de la grammaire SQL.The SQL API supports low-latency aggregation at any scale via aggregate functions COUNT, MIN, MAX, AVG, and SUM via the SQL grammar. Pour plus d’informations, consultez Fonctions d’agrégation.For more information, see Aggregate functions.

Comment l’API SQL assure-t-elle l’accès concurrentiel ?How does the SQL API provide concurrency?

L’API SQL prend en charge le contrôle d’accès concurrentiel optimiste par le biais des balises d’entité HTTP (ou ETags).The SQL API supports optimistic concurrency control (OCC) through HTTP entity tags, or ETags. Chaque ressource de l’API SQL est dotée d’une ETag définie sur le serveur à chaque mise à jour d’un document.Every SQL API resource has an ETag, and the ETag is set on the server every time a document is updated. L’en-tête et la valeur actuelle ETag sont inclus dans tous les messages de réponse.The ETag header and the current value are included in all response messages. Les ETag peuvent être utilisées avec l’en-tête If-Match pour permettre au serveur de déterminer si une ressource nécessite une mise à jour.ETags can be used with the If-Match header to allow the server to decide whether a resource should be updated. La valeur If-Match est la valeur ETag utilisée pour la vérification.The If-Match value is the ETag value to be checked against. Si la valeur ETag correspond à la valeur ETag du serveur, la ressource est mise à jour.If the ETag value matches the server ETag value, the resource is updated. Si l’ETag n’est plus actuelle, le serveur rejette l’opération en retournant un code de réponse « HTTP 412 Échec de la condition préalable ».If the ETag is no longer current, the server rejects the operation with an "HTTP 412 Precondition failure" response code. Dans ce cas, le client extrait à nouveau la ressource afin d’obtenir la valeur ETag actuelle pour la ressource.The client then refetches the resource to acquire the current ETag value for the resource. De plus, les ETag peuvent être utilisées avec l’en-tête If-None-Match pour déterminer si une nouvelle extraction d’une ressource est nécessaire.In addition, ETags can be used with the If-None-Match header to determine whether a refetch of a resource is needed.

Pour utiliser l’accès concurrentiel optimiste dans .NET, utilisez la classe AccessCondition .To use optimistic concurrency in .NET, use the AccessCondition class. Pour un exemple .NET, voir Program.cs dans l’exemple DocumentManagement sur github.For a .NET sample, see Program.cs in the DocumentManagement sample on GitHub.

Comment effectuer des transactions dans l’API SQL ?How do I perform transactions in the SQL API?

L’API SQL prend en charge les transactions intégrées au langage par le biais de déclencheurs et de procédures stockées JavaScript.The SQL API supports language-integrated transactions via JavaScript-stored procedures and triggers. Toutes les opérations de base de données à l’intérieur des scripts sont exécutées en isolement de capture instantanée.All database operations inside scripts are executed under snapshot isolation. S’il s’agit d’une collection à partition unique, l’exécution est étendue à la collection.If it's a single-partition collection, the execution is scoped to the collection. Si la collection est partitionnée, l’exécution est étendue aux documents ayant la même valeur de clé de partition au sein de la collection.If the collection is partitioned, the execution is scoped to documents with the same partition-key value within the collection. Une capture instantanée des versions des documents (ETags) est prise au début de la transaction et validée uniquement si le script fonctionne.A snapshot of the document versions (ETags) is taken at the start of the transaction and committed only if the script succeeds. Si le JavaScript renvoie une erreur, la transaction est annulée.If the JavaScript throws an error, the transaction is rolled back. Pour plus d’informations, consultez Programmation en JavaScript côté serveur pour Azure Cosmos DB.For more information, see Server-side JavaScript programming for Azure Cosmos DB.

Comment insérer des documents en bloc dans Cosmos DB ?How can I bulk-insert documents into Cosmos DB?

Vous pouvez insérer en bloc des documents dans Azure Cosmos DB de l’une des façons suivantes :You can bulk-insert documents into Azure Cosmos DB in one of the following ways:

Oui. Azure Cosmos DB étant un service RESTful, les liens de ressource sont immuables et peuvent être mis en cache.Yes, because Azure Cosmos DB is a RESTful service, resource links are immutable and can be cached. Les clients de l’API SQL peuvent spécifier un en-tête « If-None-Match » pour des lectures effectuées en comparaison avec des documents ou collections de type ressource, puis mettre à jour leurs copies locales après modification de la version du serveur.SQL 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.

Une instance locale de l’API SQL est-elle disponible ?Is a local instance of SQL API available?

Oui.Yes. L’émulateur Azure Cosmos DB fournit une émulation haute fidélité du service Cosmos DB.The Azure Cosmos DB Emulator provides a high-fidelity emulation of the Cosmos DB service. Il prend en charge les mêmes fonctionnalités qu’Azure Cosmos DB, dont la création et l’interrogation de documents JSON, l’approvisionnement et la mise à l’échelle des collections, et l’exécution des procédures stockées et déclencheurs.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. Vous pouvez développer et tester des applications à l’aide de l’émulateur Azure Cosmos DB, puis les déployer vers Azure à une échelle globale en apportant une simple modification à la configuration du point de terminaison de connexion pour 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.

Pourquoi les longues valeurs à virgule flottante dans un document sont-elles arrondies quand elles sont affichées à partir de l’Explorateur de données dans le portail ?Why are long floating-point values in a document rounded when viewed from data explorer in the portal.

Il s’agit d’une limitation propre à JavaScript.This is limitation of JavaScript. JavaScript utilise des nombres de format à virgule flottante double précision comme spécifié dans la norme IEEE 754 et elle peut contenir en toute sécurité les nombres compris entre-(253 -1) et 253-1 (par exemple, 9007199254740991) uniquement.JavaScript uses double-precision floating-point format numbers as specified in IEEE 754 and it can safely hold numbers between -(253 - 1) and 253-1 (i.e., 9007199254740991) only.

Où se trouvent les autorisations accordées dans la hiérarchie d’objets ?Where are permissions allowed in the object hierarchy?

La création d’autorisations à l’aide de ResourceTokens est autorisée au niveau du conteneur et de ses descendants (tels que les documents ou les pièces jointes).Creating permissions by using ResourceTokens is allowed at the container level and its descendants (such as documents, attachments). Cela implique qu’une tentative de création d’autorisation au niveau de la base de données ou du compte n’est pas autorisée actuellement.This implies that trying to create a permission at the database or an account level isn't currently allowed.

API d’Azure Cosmos DB pour MongoDBAzure Cosmos DB's API for MongoDB

Présentation de l’API Azure Cosmos DB pour MongoDBWhat is the Azure Cosmos DB's API for MongoDB?

L’API de Azure Cosmos DB pour MongoDB est une couche de compatibilité de protocole de communication qui permet aux applications de communiquer facilement et en toute transparence avec le moteur de base de données Azure Cosmos DB natif à l’aide de kits de développement logiciel et les pilotes existants, soutenu par la Communauté pour MongoDB.The Azure Cosmos DB's API for MongoDB is a wire-protocol compatibility layer that allows applications to easily and transparently communicate with the native Azure Cosmos DB database engine by using existing, community-supported SDKs and drivers for MongoDB. Les développeurs peuvent maintenant utiliser les compétences et les chaînes d’outils MongoDB existants pour créer des applications qui tirent parti d’Azure Cosmos DB.Developers can now use existing MongoDB toolchains and skills to build applications that take advantage of Azure Cosmos DB. Les développeurs bénéficient des fonctionnalités uniques d’Azure Cosmos DB, qui incluent la distribution globale avec une réplication multimaître, maintenance de sauvegarde, l’indexation automatique, soutenu financièrement les contrats de niveau de service (SLA) etc.Developers benefit from the unique capabilities of Azure Cosmos DB, which include global distribution with multi-master replication, auto-indexing, backup maintenance, financially backed service level agreements (SLAs) etc.

Comment se connecter à une base de données ?How do I connect to my database?

Pour se connecter à une base de données Cosmos avec l’API Azure Cosmos DB pour MongoDB, la solution la plus rapide consiste à passer par le portail Azure.The quickest way to connect to a Cosmos database with Azure Cosmos DB's API for MongoDB is to head over to the Azure portal. Accédez à votre compte, puis, dans le menu de navigation à gauche, cliquez sur Démarrage rapide.Go to your account and then, on the left navigation menu, click Quick Start. Guide de démarrage rapide est la meilleure façon d’obtenir des extraits de code pour vous connecter à votre base de données.Quickstart is the best way to get code snippets to connect to your database.

Azure Cosmos DB applique des normes et des exigences strictes en matière de sécurité.Azure Cosmos DB enforces strict security requirements and standards. Les comptes Azure Cosmos DB nécessitant une authentification et une communication sécurisée via SSL, veillez à utiliser TLSv1.2.Azure Cosmos DB accounts require authentication and secure communication via SSL, so be sure to use TLSv1.2.

Pour plus d’informations, consultez Se connecter à une base de données Cosmos avec l’API Azure Cosmos DB pour MongoDB.For more information, see Connect to your Cosmos database with Azure Cosmos DB's API for MongoDB.

Existe-t-il des codes d’erreur supplémentaires à gérer durant l’utilisation de l’API Azure Cosmos DB pour MongoDB ?Are there additional error codes that I need to deal with while using Azure Cosmos DB's API for MongoDB?

Parallèlement aux codes d’erreur MongoDB habituels, l’API Azure Cosmos DB pour MongoDB présente ses propres codes d’erreur :Along with the common MongoDB error codes, the Azure Cosmos DB's API for MongoDB has its own specific error codes:

ErrorError CodeCode Description Description SolutionSolution
TooManyRequestsTooManyRequests 1650016500 Le nombre total d’unités de requête consommées est supérieur au taux d’unités de requête provisionné pour la collection et a été limité.The total number of request units consumed is more than the provisioned request-unit rate for the collection and has been throttled. Adaptez le débit assigné à un conteneur ou à un ensemble de conteneurs à partir du portail Azure ou renouvelez l’opération.Consider scaling the throughput assigned to a container or a set of containers from the Azure portal or retrying again.
ExceededMemoryLimitExceededMemoryLimit 1650116501 En tant que service multi-locataire, l’opération a dépassé l’allocation de mémoire du client.As a multi-tenant service, the operation has gone over the client's memory allotment. Réduisez l’étendue de l’opération en fixant un critère de requête plus restrictif, ou contactez le support technique via le portail Azure.Reduce the scope of the operation through more restrictive query criteria or contact support from the Azure portal.

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

Est-ce que le pilote Simba pour MongoDB est pris en charge dans l’utilisation de l’API Azure Cosmos DB pour MongoDB ?Is the Simba driver for MongoDB supported for use with Azure Cosmos DB's API for MongoDB?

Oui, vous pouvez utiliser le pilote Mongo ODBC de Simba avec l’API Azure Cosmos DB pour MongoDB.Yes, you can use Simba’s Mongo ODBC driver with Azure Cosmos DB's API for MongoDB

API de tableTable API

Comment utiliser l’offre de l’API Table ?How can I use the Table API offering?

L’API Table d’Azure Cosmos DB est disponible dans le portail Azure.The Azure Cosmos DB Table API is available in the Azure portal. Vous devez d’abord souscrire un abonnement Microsoft Azure.First you must sign up for an Azure subscription. Une fois inscrit, vous pouvez ajouter un compte d’API Table d’Azure Cosmos DB à votre abonnement Azure, puis ajouter des tables à votre compte.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.

Vous trouverez les langages pris en charge et les démarrages rapides associés dans Présentation de l’API Table d’Azure Cosmos DB.You can find the supported languages and associated quick-starts in the Introduction to Azure Cosmos DB Table API.

Ai-je besoin d’un nouveau kit SDK pour utiliser l’API Table ?Do I need a new SDK to use the Table API?

Non, les kits SDK de stockage existants doivent continuer de fonctionner.No, existing storage SDKs should still work. Toutefois, nous vous recommandons de vous procurer les derniers kits SDK pour optimiser la prise en charge et, dans de nombreux cas, améliorer les performances.However, it's recommended that one always gets the latest SDKs for the best support and in many cases superior performance. Consultez la liste des langages disponibles dans Présentation de l’API Table d’Azure Cosmos DB.See the list of available languages in the Introduction to Azure Cosmos DB Table API.

Quelles sont les différences de comportement entre l’API Table et le stockage Table Azure ?Where is Table API not identical with Azure Table storage behavior?

Si vous avez déjà créé des tables dans le stockage Table Azure et que vous souhaitez passer à l’API Table d’Azure Cosmos DB, tenez compte des différences de comportement suivantes :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 Table d’Azure Cosmos DB utilise un modèle de capacité réservée pour garantir les performances. Que vous l’utilisez ou non, la capacité vous est donc facturée dès que la table est créée.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. Dans le cadre du stockage Table Azure, vous payez uniquement la capacité utilisée.With Azure Table storage one only pays for capacity that's used. Cela explique pourquoi l’API Table peut offrir un contrat de niveau de service (SLA) de 10 ms en lecture et de 15 ms en écriture au 99e centile, alors que le stockage Table Azure offre un SLA de 10 s.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. Même les tables vides sans requêtes de l’API Table engendrent donc des coûts pour assurer la disponibilité de la capacité et le traitement de toutes les requêtes selon les termes du SLA offert par 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.
  • Résultats de la requête retournées par l’API de Table ne sont pas triés dans l’ordre des clés de ligne/partition car elles se trouvent dans le stockage Table Azure.Query results returned by the Table API aren't sorted in partition key/row key order as they are in Azure Table storage.
  • Les clés de ligne ne peuvent pas dépasser 255 octets.Row keys can only be up to 255 bytes
  • Les lots ne peuvent contenir que jusqu’à 2 MoBatches can only have up to 2 MBs
  • CORS n’est pas pris en charge actuellementCORS isn't currently supported
  • Noms de tables dans le stockage Table Azure ne sont pas la casse, mais elles se trouvent dans l’API de Table Azure Cosmos DBTable names in Azure Table storage aren't case-sensitive, but they are in Azure Cosmos DB Table API
  • Certains des formats internes Azure Cosmos DB pour les informations de codage, comme les champs binaires, ne sont actuellement pas aussi efficaces que souhaité.Some of Azure Cosmos DB's internal formats for encoding information, such as binary fields, are currently not as efficient as one might like. Par conséquent, des limitations inattendues sur la taille des données peuvent être observées.Therefore this can cause unexpected limitations on data size. Par exemple, il n’est actuellement pas possible d’utiliser le méga-octet complet d’une entité de table pour stocker des données binaires, car l’encodage augmente la taille des données.For example, currently one couldn't use the full one Meg of a table entity to store binary data because the encoding increases the data's size.
  • Nom de propriété d’entité « ID » est actuellement ne pas pris en chargeEntity property name 'ID' currently not supported
  • TableQuery TakeCount n’est pas limité à 1000TableQuery TakeCount isn't limited to 1000

En ce qui concerne l’API REST, il existe un certain nombre d’options liées aux points de terminaison/requêtes qui ne sont pas prises en charge par l’API Table d’Azure Cosmos DB :In terms of the REST API there are a number of endpoints/query options that aren't supported by Azure Cosmos DB Table API:

Méthode(s) RESTRest Method(s) Option de point de terminaison/requête RESTRest Endpoint/Query Option URL vers la documentationDoc URLs ExplicationExplanation
GET, PUTGET, PUT /?restype=service@comp=properties/?restype=service@comp=properties Définir les propriétés du service Table et Obtenir les propriétés du service TableSet Table Service Properties and Get Table Service Properties Ce point de terminaison est utilisé pour définir les règles CORS, la configuration de Storage Analytics et les paramètres de journalisation.This endpoint is used to set CORS rules, storage analytics configuration, and logging settings. CORS n’est pas actuellement pris en charge, et l’analytique et la journalisation sont gérées différemment dans Azure Cosmos DB et dans les tables Stockage Azure.CORS is currently not supported and analytics and logging are handled differently in Azure Cosmos DB than Azure Storage Tables
OPTIONSOPTIONS /<table-resource-name>/<table-resource-name> Requête de table CORS préliminairePre-flight CORS table request Cette option fait partie de CORS, qui n’est pas pris en charge par Azure Cosmos DB pour l’instant.This is part of CORS which Azure Cosmos DB doesn't currently support.
GETGET /?restype=service@comp=stats/?restype=service@comp=stats Obtenir les statistiques du service TableGet Table Service Stats Fournit des informations sur la rapidité de la réplication des données entre un emplacement principal et un emplacement secondaire.Provides information how quickly data is replicating between primary and secondaries. Cette option est inutile dans Cosmos DB puisque la réplication fait partie des écritures.This isn't needed in Cosmos DB as the replication is part of writes.
GET, PUTGET, PUT /mytable?comp=acl/mytable?comp=acl Obtenir la liste de contrôle d’accès de la table et Définir la liste de contrôle d’accès de la tableGet Table ACL and Set Table ACL Obtient et définit les stratégies d’accès stocké utilisées pour gérer les signatures d’accès partagé.This gets and sets the stored access policies used to manage Shared Access Signatures (SAS). Bien que ces signatures soient prises en charge, elles sont définies et gérées différemment.Although SAS is supported, they are set and managed differently.

De plus, l’API Table d’Azure Cosmos DB prend uniquement en charge le format JSON (ATOM n’est pas pris en charge).In addition Azure Cosmos DB Table API only supports the JSON format, not ATOM.

Si les signatures d‘accès partagé sont prises en charge par Azure Cosmos DB, certaines stratégie ne le sont pas, notamment celles liées aux opérations de gestion comme le droit de créer des tables.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.

Pour le kit SDK .NET en particulier, certaines classes et méthodes ne sont pas prises en charge par Azure Cosmos DB pour l’instant.For the .NET SDK in particular, there are some classes and methods that Azure Cosmos DB doesn't currently support.

ClasseClass Méthode non prise en chargeUnsupported Method
CloudTableClientCloudTableClient *ServiceProperties**ServiceProperties*
*ServiceStats**ServiceStats*
CloudTableCloudTable SetPermissions*SetPermissions*
GetPermissions*GetPermissions*
TableServiceContextTableServiceContext * (cette classe est dépréciée)* (this class is deprecated)
TableServiceContextTableServiceEntity " "" "
TableServiceExtensionsTableServiceExtensions " "" "
TableServiceContextTableServiceQuery " "" "

Si l’une de ces différences constitue un obstacle pour votre projet, contactez askcosmosdb@microsoft.com.If any of these differences are a problem for your project, contact askcosmosdb@microsoft.com and let us know.

Comment formuler des commentaires sur le Kit de développement logiciel (SDK) ou des bogues ?How do I provide feedback about the SDK or bugs?

Vous pouvez partager vos commentaires par les biais suivants :You can share your feedback in any of the following ways:

Quelle chaîne de connexion faut-il utiliser pour se connecter à l’API Table ?What is the connection string that I need to use to connect to the Table API?

La chaîne de connexion est :The connection string is:

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

Vous pouvez obtenir la chaîne de connexion dans la page Chaîne de connexion du portail Azure.You can get the connection string from the Connection String page in the Azure portal.

Comment faire pour remplacer les paramètres de configuration des options de requête dans le kit SDK .NET pour l’API Table ?How do I override the config settings for the request options in the .NET SDK for the Table API?

Certains paramètres sont gérés sur la méthode de CreateCloudTableClient et d’autres par le biais du fichier app.config dans la section appSettings de l’application cliente.Some settings are handled on the CreateCloudTableClient method and other via the app.config in the appSettings section in the client application. Pour plus d’informations sur les paramètres de configuration, voir Fonctionnalités d’Azure Cosmos DB.For information about config settings, see Azure Cosmos DB capabilities.

Y a-t-il des changements pour les clients qui utilisent les kits SDK de stockage Table Azure existants ?Are there any changes for customers who are using the existing Azure Table storage SDKs?

Aucune.None. Il n’y a aucune modification pour les clients existants ou nouveaux utilisant le Kit de développement logiciel (SDK) de stockage Table Azure existant.There are no changes for existing or new customers who are using the existing Azure Table storage SDKs.

Comment faire pour afficher les données de table qui sont stockées dans Azure Cosmos DB afin de les utiliser avec l’API Table ?How do I view table data that's stored in Azure Cosmos DB for use with the Table API?

Vous pouvez utiliser le portail Azure pour parcourir les données.You can use the Azure portal to browse the data. Vous pouvez également utiliser le code ou les outils de l’API Table mentionnés dans la réponse suivante.You can also use the Table API code or the tools mentioned in the next answer.

Quels sont les outils qui fonctionnent avec l’API Table ?Which tools work with the Table API?

Vous pouvez utiliser l’Explorateur Stockage Azure.You can use the Azure Storage Explorer.

Les outils offrant la flexibilité nécessaire pour prendre une chaîne de connexion au format spécifié précédemment peuvent prendre en charge la nouvelle API Table.Tools with the flexibility to take a connection string in the format specified previously can support the new Table API. Vous trouverez une liste des outils de table dans la page Outils clients d’Azure Storage.A list of table tools is provided on the Azure Storage Client Tools page.

L’accès concurrentiel sur les opérations est-il contrôlé ?Is the concurrency on operations controlled?

Oui, l’accès concurrentiel optimiste est fourni via l’utilisation du mécanisme ETag.Yes, optimistic concurrency is provided via the use of the ETag mechanism.

Le modèle de requête OData est-il pris en charge pour les entités ?Is the OData query model supported for entities?

Oui, l’API Table prend en charge les requêtes OData et LINQ.Yes, the Table API supports OData query and LINQ query.

Puis-je me connecter côte à côte au stockage Table Azure et à l’API Table d’Azure Cosmos DB dans la même application ?Can I connect to Azure Table Storage and Azure Cosmos DB Table API side by side in the same application?

Oui, vous pouvez vous connecter en créant deux instances distinctes de CloudTableClient, chacune pointant vers son propre URI via la chaîne de connexion.Yes, you can connect by creating two separate instances of the CloudTableClient, each pointing to its own URI via the connection string.

Comment faire pour migrer une application de stockage Table Azure existante vers cette offre ?How do I migrate an existing Azure Table storage application to this offering?

AzCopy et l‘outil de migration de données Azure Cosmos DB sont tous les deux pris en charge.AzCopy and the Azure Cosmos DB Data Migration Tool are both supported.

Comment l’extension de la taille de stockage est-elle gérée pour ce service, par exemple, si je commence par n Go de données et que le volume de celles-ci passe à 1 To au fil du temps ?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 est conçu pour offrir une capacité de stockage illimitée via l’utilisation de la mise à l’échelle horizontale.Azure Cosmos DB is designed to provide unlimited storage via the use of horizontal scaling. Le service peut surveiller votre stockage et en augmenter efficacement le volume.The service can monitor and effectively increase your storage.

Comment faire pour surveiller l’offre de l’API Table ?How do I monitor the Table API offering?

Le volet Métriques de l’API Table permet de surveiller les requêtes et l’utilisation du stockage.You can use the Table API Metrics pane to monitor requests and storage usage.

Comment calculer le débit dont j’ai besoin ?How do I calculate the throughput I require?

Vous pouvez utiliser l’estimateur de capacité pour calculer le débit de table requis pour les opérations.You can use the capacity estimator to calculate the TableThroughput that's required for the operations. Pour plus d’informations, voir Estimer les unités de requête et le stockage de données.For more information, see Estimate Request Units and Data Storage. En général, vous pouvez afficher votre entité au format JSON, et fournir les valeurs pour vos opérations.In general, you can show your entity as JSON and provide the numbers for your operations.

Puis-je utiliser le kit SDK de l’API Table localement avec l’émulateur ?Can I use the Table API SDK locally with the emulator?

Pas pour l'instant.Not at this time.

Mon application existante peut-elle fonctionner avec l’API Table ?Can my existing application work with the Table API?

Oui, la même API est prise en charge.Yes, the same API is supported.

Dois-je migrer mes applications de stockage Table Azure existantes vers le nouveau kit SDK si je ne souhaite pas utiliser les fonctionnalités de l’API Table ?Do I need to migrate my existing Azure Table storage applications to the SDK if I don't want to use the Table API features?

Non, vous pouvez créer et utiliser des ressources de stockage Table Azure existantes sans la moindre interruption.No, you can create and use existing Azure Table storage assets without interruption of any kind. Toutefois, si vous n’utilisez pas l’API Table, vous ne pouvez pas bénéficier de l’indexation automatique, de l’option de cohérence supplémentaire ou de la distribution mondiale.However, if you don't use the Table API, you can't benefit from the automatic index, the additional consistency option, or global distribution.

Comment ajouter la réplication des données de l’API Table dans plusieurs régions Azure ?How do I add replication of the data in the Table API across more than one region of Azure?

Vous pouvez utiliser les paramètres de réplication globale du portail Azure Cosmos DB pour ajouter des régions appropriées pour votre application.You can use the Azure Cosmos DB portal's global replication settings to add regions that are suitable for your application. Pour développer une application distribuée globalement, vous devez également ajouter votre application avec les informations PreferredLocation définies sur la région locale afin de bénéficier d’une faible latence de lecture.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.

Comment faire pour changer la région d’écriture principale du compte dans l’API Table ?How do I change the primary write region for the account in the Table API?

Vous pouvez utiliser le volet du portail de réplication globale d’Azure Cosmos DB pour ajouter une région, puis basculer vers la région requise.You can use the Azure Cosmos DB global replication portal pane to add a region and then fail over to the required region. Pour des instructions, voir Développement avec des comptes Azure Cosmos DB multirégions.For instructions, see Developing with multi-region Azure Cosmos DB accounts.

Comment configurer mes régions de lecture préférées pour une faible latence lors de la distribution de mes données ?How do I configure my preferred read regions for low latency when I distribute my data?

Pour faciliter la lecture à partir de l’emplacement local, utilisez la clé PreferredLocation dans le fichier app.config.To help read from the local location, use the PreferredLocation key in the app.config file. Pour les applications existantes, l’API Table génère une erreur si LocationMode est défini.For existing applications, the Table API throws an error if LocationMode is set. Supprimez ce code, car l’API Table extrait ces informations du fichier app.config.Remove that code, because the Table API picks up this information from the app.config file.

En quoi consistent les niveaux de cohérence dans l’API Table ?How should I think about consistency levels in the Table API?

Azure Cosmos DB adopte des compromis bien pensés entre cohérence, disponibilité et latence.Azure Cosmos DB provides well-reasoned trade-offs between consistency, availability, and latency. Azure Cosmos DB offre cinq niveaux de cohérence aux développeurs de l’API Table. Vous pouvez donc choisir le modèle de cohérence approprié au niveau de la table, et effectuer des demandes individuelles lors de l’interrogation des données.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. Quand un client se connecte, il peut spécifier un niveau de cohérence.When a client connects, it can specify a consistency level. Vous pouvez changer le niveau à l’aide de l’argument consistencyLevel de CreateCloudTableClient.You can change the level via the consistencyLevel argument of CreateCloudTableClient.

L’API Table permet d’effectuer des lectures à faible latence avec l’option « Lire vos écritures » et le niveau de cohérence Obsolescence limitée par défaut.The Table API provides low-latency reads with "Read your own writes," with Bounded-staleness consistency as the default. Pour plus d’informations, consultez Niveaux de cohérence.For more information, see Consistency levels.

Par défaut, Stockage de table Azure offre une Cohérence forte au sein d’une région et une Cohérence éventuelle dans les sites secondaires.By default, Azure Table storage provides Strong consistency within a region and Eventual consistency in the secondary locations.

L’API Table d’Azure Cosmos DB offre-t-elle davantage de niveaux de cohérence que le stockage Table Azure ?Does Azure Cosmos DB Table API offer more consistency levels than Azure Table storage?

Oui, pour plus d’informations sur la façon de tirer parti de la nature distribuée d’Azure Cosmos DB, voir Niveaux de cohérence.Yes, for information about how to benefit from the distributed nature of Azure Cosmos DB, see Consistency levels. Des garanties étant fournies pour les niveaux de cohérence, vous pouvez utiliser ceux-ci en toute confiance.Because guarantees are provided for the consistency levels, you can use them with confidence.

Une fois la distribution globale activée, combien de temps faut-il pour répliquer les données ?When global distribution is enabled, how long does it take to replicate the data?

Azure Cosmos DB valide les données durablement dans la région locale, et envoie les données vers les autres régions immédiatement, en quelques millisecondes.Azure Cosmos DB commits the data durably in the local region and pushes the data to other regions immediately in a matter of milliseconds. Cette réplication dépend uniquement de la durée des boucles (RTT) du centre de données.This replication is dependent only on the round-trip time (RTT) of the datacenter. Pour en savoir plus sur la fonctionnalité de distribution globale d’Azure Cosmos DB, voir Azure Cosmos DB : Un service de base de données mondialement distribué sur Azure.To learn more about the global-distribution capability of Azure Cosmos DB, see Azure Cosmos DB: A globally distributed database service on Azure.

Est-il possible de modifier le niveau cohérence des demandes de lecture ?Can the read request consistency level be changed?

Azure Cosmos DB permet de définir le niveau de cohérence au niveau du conteneur (sur la table).With Azure Cosmos DB, you can set the consistency level at the container level (on the table). Le kit SDK .NET vous permet de changer le niveau en fournissant la valeur de la clé TableConsistencyLevel dans le fichier app.config.By using the .NET SDK, you can change the level by providing the value for TableConsistencyLevel key in the app.config file. Les valeurs possibles sont les suivantes : Forte, Obsolescence limitée, Session, Préfixe cohérent et Éventuelle.The possible values are: Strong, Bounded Staleness, Session, Consistent Prefix, and Eventual. Pour plus d’informations, voir Niveaux de cohérence ajustables dans Azure Cosmos DB.For more information, see Tunable data consistency levels in Azure Cosmos DB. L’idée clé est que vous ne pouvez pas définir un niveau de cohérence de requête HTTP supérieur à celui défini pour la table.The key idea is that you can't set the request consistency level at more than the setting for the table. Par exemple, vous ne pouvez pas définir le niveau de cohérence pour la table sur Éventuelle et le niveau de cohérence de requête sur Forte.For example, you can't set the consistency level for the table at Eventual and the request consistency level at Strong.

Comment l’API Table gère-t-elle le basculement en cas de défaillance d’une région ?How does the Table API handle failover if a region goes down?

L’API Table tire parti de la plateforme mondialement distribuée d’Azure Cosmos DB.The Table API leverages the globally distributed platform of Azure Cosmos DB. Pour vous assurer que votre application peut tolérer des temps d’arrêt de centre de données, activez au moins une région supplémentaire pour le compte dans le portail Azure Cosmos DB (voir Développement avec des comptes Azure Cosmos DB multirégions).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. Vous pouvez définir la priorité de la région à l’aide du portail (voir Developing with multi-region Azure Cosmos DB accounts (Développement avec des comptes Azure Cosmos DB multirégions)).You can set the priority of the region by using the portal Developing with multi-region Azure Cosmos DB accounts.

Vous pouvez ajouter autant de régions que vous le souhaitez pour le compte, et contrôler l’emplacement de basculement en indiquant une priorité.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. Pour utiliser la base de données, vous devez également fournir une application à cet emplacement.To use the database, you need to provide an application there too. Si vous procédez de la sorte, vos clients ne subissent aucun temps d’arrêt.When you do so, your customers won't experience downtime. À la différence des autres kits SDK, la dernière version du kit SDK client .NET prend en charge l’hébergement automatique.The latest .NET client SDK is auto homing but the other SDKs aren't. Autrement dit, il peut détecter la région défaillante et basculer automatiquement vers la nouvelle région.That is, it can detect the region that's down and automatically fail over to the new region.

L’API Table prend-elle en charge les sauvegardes ?Is the Table API enabled for backups?

Oui, l’API Table tire parti de la plateforme d’Azure Cosmos DB pour les sauvegardes.Yes, the Table API leverages the platform of Azure Cosmos DB for backups. Les sauvegardes sont effectuées automatiquement.Backups are made automatically. Pour plus d’informations, voir Sauvegarde et restauration en ligne automatiques avec Azure Cosmos DB.For more information, see Online backup and restore with Azure Cosmos DB.

L’API Table indexe-t-elle par défaut tous les attributs d’une entité ?Does the Table API index all attributes of an entity by default?

Oui, tous les attributs d’une entité sont indexés par défaut.Yes, all attributes of an entity are indexed by default. Pour plus d’informations, voir Azure Cosmos DB : Stratégies d’indexation.For more information, see Azure Cosmos DB: Indexing policies.

Cela signifie-t-il que je n’ai pas besoin de créer plusieurs index pour satisfaire les requêtes ?Does this mean I don't have to create more than one index to satisfy the queries?

Oui, l’API Table d’Azure Cosmos DB assure l’indexation automatique de tous les attributs sans aucune définition de schéma.Yes, Azure Cosmos DB Table API provides automatic indexing of all attributes without any schema definition. Cette automatisation permet aux développeurs de se concentrer sur l’application plutôt que sur la création et la gestion d’index.This automation frees developers to focus on the application rather than on index creation and management. Pour plus d’informations, voir Azure Cosmos DB : Stratégies d’indexation.For more information, see Azure Cosmos DB: Indexing policies.

Puis-je modifier la stratégie d’indexation ?Can I change the indexing policy?

Oui, vous pouvez modifier la stratégie d’indexation en fournissant la définition d’index.Yes, you can change the indexing policy by providing the index definition. Vous devez correctement encoder et placer dans une séquence d’échappement les paramètres.You need to properly encode and escape the settings.

Pour les kits SDK non-.NET, la stratégie d’indexation peut uniquement être définie dans le portail au niveau de l’Explorateur de données. Naviguez jusqu’à la table à changer, accédez à Mise à l‘échelle et paramètres -> Stratégie d‘indexation, effectuez le changement souhaité, puis cliquez sur Enregistrer.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.

À partir du kit SDK .NET, vous pouvez la soumettre dans le fichier 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"
 }
]
}

Azure Cosmos DB en tant que plateforme semble avoir de nombreuses fonctionnalités, telles que le tri, l’agrégation, la hiérarchisation et autres.Azure Cosmos DB as a platform seems to have lot of capabilities, such as sorting, aggregates, hierarchy, and other functionality. Allez-vous ajouter ces fonctionnalités à l’API Table ?Will you be adding these capabilities to the Table API?

L’API Table offre les mêmes fonctionnalités de requête que le stockage Table Azure.The Table API provides the same query functionality as Azure Table storage. Azure Cosmos DB prend également en charge le tri, les agrégats, les requêtes géospatiales, les hiérarchies et un large éventail de fonctions intégrées.Azure Cosmos DB also supports sorting, aggregates, geospatial query, hierarchy, and a wide range of built-in functions. Pour plus d’informations, consultez la section Requêtes SQL.For more information, see SQL queries.

Quand dois-je changer le débit de table (TableThroughput) pour l’API Table ?When should I change TableThroughput for the Table API?

Vous devez modifier débit de table (TableThroughput) dans les situations suivantes :You should change TableThroughput when either of the following conditions applies:

  • Vous effectuez une opération d’extraction, transformation et chargement (ETL) de données, ou souhaitez charger une grande quantité de données dans un laps de temps court.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.
  • Vous avez besoin d’un débit supérieur du conteneur ou d’un ensemble de conteneurs sur le backend.You need more throughput from the container or from a set of containers at the back end. Par exemple, vous voyez que le débit utilisé est supérieur au débit provisionné, et vous êtes limité.For example, you see that the used throughput is more than the provisioned throughput, and you're getting throttled. Pour plus d’informations, consultez Définir le débit des conteneurs Azure Cosmos DB.For more information, see Set throughput for Azure Cosmos DB containers.

Puis-je augmenter ou réduire le débit ma table d’API Table ?Can I scale up or scale down the throughput of my Table API table?

Oui, vous pouvez utiliser le volet de mise à l’échelle du portail Azure Cosmos DB pour régler le débit.Yes, you can use the Azure Cosmos DB portal's scale pane to scale the throughput. Pour plus d’informations, voir Définir le débit.For more information, see Set throughput.

Un débit de table (TableThroughput) par défaut est-il défini pour les nouvelles tables approvisionnées ?Is a default TableThroughput set for newly provisioned tables?

Oui, si vous ne remplacez pas le débit de table (TableThroughput) dans le fichier app.config et n’utilisez pas de conteneur créé préalablement dans Azure Cosmos DB, le service crée une table dont le débit est défini sur 400.Yes, if you don't override the TableThroughput via app.config and don't use a pre-created container in Azure Cosmos DB, the service creates a table with throughput of 400.

Les prix varient-ils pour les clients existants du service de stockage Table Azure ?Is there any change of pricing for existing customers of the Azure Table storage service?

Aucune.None. Le tarif reste inchangé pour les clients existants du stockage Table Azure.There's no change in price for existing Azure Table storage customers.

Comment le prix est-il calculé pour l’API Table ?How is the price calculated for the Table API?

Cela dépend du débit de table (TableThroughput) alloué.The price depends on the allocated TableThroughput.

Comment faire pour gérer les limitations de taux qui affectent les tables dans l’offre API Table ?How do I handle any rate limiting on the tables in Table API offering?

Si le taux de requêtes dépasse la capacité du débit provisionné pour le conteneur sous-jacent ou un ensemble de conteneurs, vous recevez une erreur et le SDK essaie de renouveler l’appel en appliquant la stratégie de nouvelle tentative.If the request rate is more than the capacity of the provisioned throughput for the underlying container or a set of containers, you get an error, and the SDK retries the call by applying the retry policy.

Pourquoi dois-je choisir un débit en dehors de PartitionKey et de RowKey pour tirer parti de l’offre API Table d’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?

Si vous ne spécifiez pas de débit par défaut pour votre conteneur dans le fichier app.config ou par le biais du portail, Azure Cosmos DB en définit un.Azure Cosmos DB sets a default throughput for your container if you don't provide one in the app.config file or via the portal.

Azure Cosmos DB fournit des garanties de performances et de latence avec des limites supérieures pour les opérations.Azure Cosmos DB provides guarantees for performance and latency, with upper bounds on operation. Cette garantie est possible lorsque le moteur peut assurer la gouvernance des opérations du client.This guarantee is possible when the engine can enforce governance on the tenant's operations. La définition du débit de table (TableThroughput) est pour vous l’assurance de bénéficier du débit et de la latence garantis, car la plateforme réserve cette capacité et garantit le succès des opérations.Setting TableThroughput ensures that you get the guaranteed throughput and latency, because the platform reserves this capacity and guarantees operational success.

La spécification du débit vous permet de modifier celui-ci en souplesse pour tirer parti du caractère saisonnier de votre application, répondre aux besoins de débit et réduire les coûts.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.

Le stockage Table Azure était peu onéreux pour moi, car je payais uniquement le stockage des données et n’effectuais que rarement des requêtes.Azure Table storage has been inexpensive for me, because I pay only to store the data, and I rarely query. L’offre API Table d’Azure Cosmos DB semble me facturer des frais alors que je n’ai pas effectué la moindre transaction ou stocké quoi que ce soit.The Azure Cosmos DB Table API offering seems to be charging me even though I haven't performed a single transaction or stored anything. Pouvez-vous m’expliquer pourquoi ?Can you explain?

Azure Cosmos DB est conçu pour être un système distribué globalement basé sur un contrat de niveau de service (SLA) offrant des garanties en matière de disponibilité, de latence et de débit.Azure Cosmos DB is designed to be a globally distributed, SLA-based system with guarantees for availability, latency, and throughput. Le débit que vous réservez dans Azure Cosmos DB est garanti, à la différence du débit d’autres systèmes.When you reserve throughput in Azure Cosmos DB, it's guaranteed, unlike the throughput of other systems. Azure Cosmos DB offre des fonctionnalités supplémentaires qui ont été demandées par les clients, telles que les index secondaires et la distribution globale.Azure Cosmos DB provides additional capabilities that customers have requested, such as secondary indexes and global distribution.

Je ne reçois jamais de notification de « quota complet » (indiquant qu’une partition est pleine) lorsque j’ingère des données dans le stockage Table Azure.I never get a quota full" notification (indicating that a partition is full) when I ingest data into Azure Table storage. Avec l’API Table, je reçois ce message.With the Table API, I do get this message. Cette offre me limite-t-elle et m’oblige-t-elle à modifier mon application existante ?Is this offering limiting me and forcing me to change my existing application?

Azure Cosmos DB est un système basé sur un contrat de niveau de service (SLA) permettant une mise à l’échelle illimitée, avec des garanties en matière de latence, de débit, de disponibilité et de cohérence.Azure Cosmos DB is an SLA-based system that provides unlimited scale, with guarantees for latency, throughput, availability, and consistency. Pour être certain de bénéficier des performances premium garanties, assurez-vous que la taille de vos données et votre index sont gérables et extensibles.To ensure guaranteed premium performance, make sure that your data size and index are manageable and scalable. La limite de 10 Go appliquée au nombre d’entités ou d’éléments par clé de partition nous permet de garantir des performances de recherche et de requête exceptionnelles.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. Pour vous assurer que la mise à l’échelle de votre application fonctionne correctement, même pour le stockage Azure, nous vous recommandons de ne pas créer de partition sensible en stockant toutes les informations dans une seule partition et en interrogeant celle-ci.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.

Si je comprends bien, une clé de partition et une clé de ligne sont toujours exigées avec l’API Table ?So PartitionKey and RowKey are still required with the Table API?

Oui.Yes. Comme la surface d’exposition de l’API Table est semblable à celle du kit SDK Stockage Table Azure, la clé de partition constitue un moyen efficace de distribuer les données.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 clé de ligne est unique au sein de cette partition.The row key is unique within that partition. La clé de ligne doit être présente et ne peut pas avoir la valeur null comme dans le Kit de développement logiciel (SDK) standard.The row key needs to be present and can't be null as in the standard SDK. La longueur de la clé de ligne est de 255 octets, et celle de la clé de partition de 1 kilo-octet.The length of RowKey is 255 bytes and the length of PartitionKey is 1 KB.

Quels sont les messages d’erreur relatifs à l’API Table ?What are the error messages for the Table API?

Étant donné que le stockage Table Azure et l’API Table d’Azure Cosmos DB utilisent les mêmes SDK, la plupart des erreurs sont identiques.Azure Table storage and Azure Cosmos DB Table API use the same SDKs so most of the errors will be the same.

Pourquoi suis-je limité quand je tente de créer successivement un grand nombre de tables dans l’API Table ?Why do I get throttled when I try to create lot of tables one after another in the Table API?

Azure Cosmos DB est un système basé sur un contrat de niveau de service (SLA) qui offre des garanties en matière de latence, de débit, de disponibilité et de cohérence.Azure Cosmos DB is an SLA-based system that provides latency, throughput, availability, and consistency guarantees. Comme il s’agit d’un système provisionné, il réserve des ressources afin de garantir le respect de ces exigences.Because it's a provisioned system, it reserves resources to guarantee these requirements. La vitesse de création des tables est détectée et limitée.The rapid rate of creation of tables is detected and throttled. Nous vous recommandons de consulter le taux de création de tables et de le réduire à moins de 5 par minute.We recommend that you look at the rate of creation of tables and lower it to less than 5 per minute. N’oubliez pas que l’API Table est un système provisionné.Remember that the Table API is a provisioned system. Dès que vous le provisionnez, vous commencez à payer.The moment you provision it, you'll begin to pay for it.

API GremlinGremlin API

Pour le développement en C#/.NET, dois-je utiliser le package Microsoft.Azure.Graphs ou Gremlin.NET ?For C#/.NET development, should I use the Microsoft.Azure.Graphs package or Gremlin.NET?

L’API Gremlin d’Azure Cosmos DB se sert des pilotes open source comme connecteurs principaux pour le service.Azure Cosmos DB Gremlin API leverages the open-source drivers as the main connectors for the service. Nous recommandons alors d’utiliser les pilotes qui sont pris en charge par Apache Tinkerpop.So the recommended option is to use drivers that are supported by Apache Tinkerpop.

Comment les RU/s sont-elles facturées lors de l’exécution des requêtes sur une base de données de graphique ?How are RU/s charged when running queries on a graph database?

Tous les objets, sommets et arêtes des graphes sont affichés sous forme de documents JSON dans le back-end.All graph objects, vertices, and edges, are shown as JSON documents in the backend. Dans la mesure où une seule requête Gremlin peut modifier un ou plusieurs objets de graphe à la fois, le coût associé est directement lié aux objets ou arêtes traités par la requête.Since one Gremlin query can modify one or many graph objects at a time, the cost associated with it is directly related to the objects, edges that are processed by the query. Azure Cosmos DB utilise le même processus pour toutes les autres API.This is the same process that Azure Cosmos DB uses for all other APIs. Pour plus d’informations, voir Unités de requête dans Azure Cosmos DB.For more information, see Request Units in Azure Cosmos DB.

Les frais de RU sont basés sur le jeu de données de travail de la traversée, et non sur le jeu de résultats.The RU charge is based on the working data set of the traversal, and not the result set. Par exemple, si une requête vise à obtenir un seul vertex en résultat mais doit traverser plusieurs autres objets sur le chemin, le coût sera basé sur tous les objets de graphe utilisés pour calculer cet unique vertex de résultat.For example, if a query aims to obtain a single vertex as a result but needs to traverse more than one other object on the way, then the cost will be based on all the graph objects that it will take to compute the one result vertex.

Quelle est la mise à l’échelle maximale qu’une base de données de graphique peut avoir dans l’API Gremlin d’Azure Cosmos DB ?What’s the maximum scale that a graph database can have in Azure Cosmos DB Gremlin API?

Azure Cosmos DB utilise le partitionnement horizontal pour répondre automatiquement aux exigences d’augmentation de stockage et de débit.Azure Cosmos DB makes use of horizontal partitioning to automatically address increase in storage and throughput requirements. Le débit et la capacité de stockage maximum d’une charge de travail sont déterminés par le nombre de partitions associées à une collection donnée.The maximum throughput and storage capacity of a workload is determined by the number of partitions that are associated with a given collection. Toutefois, une collection d’API Gremlin comporte un ensemble spécifique d’instructions pour garantir une expérience de performances à l’échelle correcte.However, a Gremlin API collection has a specific set of guidelines to ensure a proper performance experience at scale. Pour plus d’informations sur le partitionnement de données et les meilleurs pratiques, voir l’article sur le partitionnement dans Azure Cosmos DB.For more information about partitioning, and best practices, see partitioning in Azure Cosmos DB article.

Comment puis-je me protéger contre les attaques par injection à l’aide de pilotes Gremlin ?How can I protect against injection attacks using Gremlin drivers?

Les pilotes d’Apache Tinkerpop Gremlin plus natifs permettent la possibilité de fournir un dictionnaire de paramètres pour l’exécution des requêtes.Most native Apache Tinkerpop Gremlin drivers allow the option to provide a dictionary of parameters for query execution. Voici un exemple montrant comment le faire sous Gremlin.Net et Gremlin-Javascript.This is an example of how to do it in Gremlin.Net and in Gremlin-Javascript.

Pourquoi est-ce que je reçois le message d’erreur « Erreur de compilation de la requête Gremlin : Impossible de trouver une méthode » ?Why am I getting the “Gremlin Query Compilation Error: Unable to find any method” error?

L’API Gremlin d’Azure Cosmos DB implémente un sous-ensemble des fonctionnalités définies dans la surface d’exposition de Gremlin.Azure Cosmos DB Gremlin API implements a subset of the functionality defined in the Gremlin surface area. Pour voir les étapes prises en charge ou pour plus d’informations, consultez l’article Prise en charge de Gremlin.For supported steps and more information, see Gremlin support article.

La meilleure solution de contournement consiste à récrire les étapes Gremlin nécessaires avec la fonctionnalité prise en charge puisque toutes les étapes Gremlin essentielles sont prises en charge par Azure Cosmos DB.The best workaround is to rewrite the required Gremlin steps with the supported functionality, since all essential Gremlin steps are supported by Azure Cosmos DB.

Pourquoi est-ce que je reçois le message d’erreur « WebSocketException : Le serveur a retourné le code d’état "200" alors que le code d’état attendu était "101" » ?Why am I getting the “WebSocketException: The server returned status code '200' when status code '101' was expected” error?

Cette erreur survient probablement lorsqu’un point de terminaison incorrect est utilisé.This error is likely thrown when the wrong endpoint is being used. Le point de terminaison qui génère cette erreur a le modèle suivant :The endpoint that generates this error has the following pattern:

https:// YOUR_DATABASE_ACCOUNT.documents.azure.com:443/

C’est le point de terminaison de documents pour votre base de données de graphique.This is the documents endpoint for your graph database. Le bon point de terminaison à utiliser est le point de terminaison Gremlin qui a le format suivant :The correct endpoint to use is the Gremlin Endpoint, which has the following format:

https://YOUR_DATABASE_ACCOUNT.gremlin.cosmosdb.azure.com:443/

Pourquoi reçois-je le message d’erreur « RequestRateIsTooLarge » ?Why am I getting the “RequestRateIsTooLarge” error?

Cette erreur signifie que les unités de requête par seconde allouées ne sont pas suffisantes pour traiter la requête.This error means that the allocated Request Units per second aren't enough to serve the query. Cette erreur se produit généralement lorsque vous exécutez une requête qui obtient tous les vertex :This error is usually seen when you run a query that obtains all vertices:

// Query example:
g.V()

Cette requête va tenter de récupérer tous les vertex du graphique.This query will attempt to retrieve all vertices from the graph. Par conséquent, le coût de cette requête sera au moins égal au nombre de vertex en termes d’unités de requête.So, the cost of this query will be equal to at least the number of vertices in terms of RUs. Le paramètre RU/s doit être ajusté pour répondre à cette requête.The RU/s setting should be adjusted to address this query.

Pourquoi mes connexions de pilote Gremlin finissent par être supprimées ?Why do my Gremlin driver connections get dropped eventually?

Une connexion Gremlin est établie via une connexion WebSocket.A Gremlin connection is made through a WebSocket connection. Bien que les connexions WebSocket ne disposent pas d’une durée de vie spécifique, l’API Gremlin Azure Cosmos DB terminera les connexions inactives après 30 minutes d’inactivité.Although WebSocket connections don't have a specific time to live, Azure Cosmos DB Gremlin API will terminate idle connections after 30 minutes of inactivity.

Pourquoi ne puis-je pas utiliser d’appels d’API Fluent dans les pilotes Gremlin natifs ?Why can’t I use fluent API calls in the native Gremlin drivers?

Les appels d’API Fluent ne sont pas encore pris en charge par l’API Gremlin d’Azure Cosmos DB.Fluent API calls aren't yet supported by the Azure Cosmos DB Gremlin API. Les appels d’API Fluent nécessitent une fonctionnalité de mise en forme interne, appelée la « prise en charge bytecode », qui n’est actuellement pas prise en charge par l’API Gremlin d’Azure Cosmos DB.Fluent API calls require an internal formatting feature known as bytecode support that currently isn't supported by Azure Cosmos DB Gremlin API. Pour la même raison, le dernier pilote Gremlin-JavaScript n’est pas pris en charge actuellement.Due to the same reason, the latest Gremlin-JavaScript driver is also currently not supported.

Comment puis-je évaluer l’efficacité de mes requêtes Gremlin ?How can I evaluate the efficiency of my Gremlin queries?

L’étape de l’aperçu executionProfile() peut être utilisée pour fournir une analyse du plan d'exécution de la requête.The executionProfile() preview step can be used to provide an analysis of the query execution plan. Cette étape doit être ajoutée à la fin de n’importe quelle requête Gremlin comme illustré dans l’exemple suivant :This step needs to be added to the end of any Gremlin query as illustrated by the following example:

Exemple de requêteQuery example

g.V('mary').out('knows').executionProfile()

Exemple de sortieExample output

[
  {
    "gremlin": "g.V('mary').out('knows').executionProfile()",
    "totalTime": 8,
    "metrics": [
      {
        "name": "GetVertices",
        "time": 3,
        "annotations": {
          "percentTime": 37.5
        },
        "counts": {
          "resultCount": 1
        }
      },
      {
        "name": "GetEdges",
        "time": 5,
        "annotations": {
          "percentTime": 62.5
        },
        "counts": {
          "resultCount": 0
        },
        "storeOps": [
          {
            "count": 0,
            "size": 0,
            "time": 0.6
          }
        ]
      },
      {
        "name": "GetNeighborVertices",
        "time": 0,
        "annotations": {
          "percentTime": 0
        },
        "counts": {
          "resultCount": 0
        }
      },
      {
        "name": "ProjectOperator",
        "time": 0,
        "annotations": {
          "percentTime": 0
        },
        "counts": {
          "resultCount": 0
        }
      }
    ]
  }
]

La sortie du profil ci-dessus indique combien de temps est consacré à obtenir les objets de sommets, les objets edge et la taille du jeu de données de travail.The output of the above profile shows how much time is spent obtaining the vertex objects, the edge objects, and the size of the working data set. Cela concerne les mesures de coût standard pour les requêtes Azure Cosmos DB.This is related to the standard cost measurements for Azure Cosmos DB queries.

API CassandraCassandra API

Qu’est la version du protocole pris en charge par l’API Cassandra de Azure Cosmso DB ?What is the protocol version supported by Azure Cosmso DB Cassandra API? Prévoyez-vous de prendre en charge d’autres protocoles ?Is there a plan to support other protocols?

L’API Apache Cassandra pour Azure Cosmos DB prend désormais en charge CQL version 4.Apache Cassandra API for Azure Cosmos DB supports today CQL version 4. Si vous avez des commentaires sur la prise en charge d’autres protocoles, faites-le nous savoir via les commentaires user voice ou envoyez un e-mail à askcosmosdbcassandra@microsoft.com.If you have feedback about supporting other protocols, let us know via user voice feedback or send an email to askcosmosdbcassandra@microsoft.com.

Pourquoi est-il nécessaire de choisir un débit pour une table ?Why is choosing a throughput for a table a requirement?

Azure Cosmos DB définit le débit par défaut pour votre conteneur en fonction de l’emplacement à partir duquel vous créez la table (portail ou CQL).Azure Cosmos DB sets default throughput for your container based on where you create the table from - portal or CQL. Azure Cosmos DB fournit des garanties de performances et de latence avec des limites supérieures pour les opérations.Azure Cosmos DB provides guarantees for performance and latency, with upper bounds on operation. Cette garantie est possible lorsque le moteur peut assurer la gouvernance des opérations du client.This guarantee is possible when the engine can enforce governance on the tenant's operations. La définition du débit est pour vous l’assurance de bénéficier du débit et de la latence garantis, car la plateforme réserve cette capacité et garantit le succès des opérations.Setting throughput ensures that you get the guaranteed throughput and latency, because the platform reserves this capacity and guarantees operation success. Vous avez la possibilité de modifier le débit de façon élastique pour profiter de la saisonnalité de votre application et réaliser des économies.You can elastically change throughput to benefit from the seasonality of your application and save costs.

Le concept de débit est expliqué dans l’article Unités de requête dans Azure Cosmos DB.The throughput concept is explained in the Request Units in Azure Cosmos DB article. Le débit d’une table est réparti de manière équilibrée entre les partitions physiques sous-jacentes.The throughput for a table is distributed across the underlying physical partitions equally.

Quel est le nombre d’unités de requête par seconde d’une table créée via CQL ?What is the default RU/s of table when created through CQL? Comment faire pour le changer ?What If I need to change it?

Azure Cosmos DB utilise les unités de requête par seconde (RU/s) comme devise pour fournir le débit.Azure Cosmos DB uses request units per second (RU/s) as a currency for providing throughput. Les tables créées via CQL contiennent 400 unités de requêtes.Tables created through CQL have 400 RU. Vous pouvez modifier ce nombre à partir du portail.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);

Que se passe-t-il quand tout le débit a été utilisé ?What happens when throughput is used up?

Azure Cosmos DB fournit des garanties de performances et de latence avec des limites supérieures pour les opérations.Azure Cosmos DB provides guarantees for performance and latency, with upper bounds on operation. Cette garantie est possible lorsque le moteur peut assurer la gouvernance des opérations du client.This guarantee is possible when the engine can enforce governance on the tenant's operations. Cela dépend de la définition du débit, qui est pour vous l’assurance de bénéficier du débit et de la latence garantis, car la plateforme réserve cette capacité et garantit le succès des opérations.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. Quand vous dépassez cette capacité, vous obtenez un message d’erreur de surcharge indiquant que toute la capacité a été utilisée.When you go over this capacity, you get overloaded error message indicating your capacity was used up. Surcharge 0x1001 : impossible de traiter la requête, car « Le taux de demandes est élevé ».0x1001 Overloaded: the request can't be processed because "Request Rate is large". Il est alors indispensable d’identifier les opérations et les volumes à l’origine de ce problème.At this juncture, it's essential to see what operations and their volume causes this issue. Vous pouvez avoir une idée de la capacité consommée dépassant la capacité provisionnée grâce aux indicateurs de performances dans le portail.You can get an idea about consumed capacity going over the provisioned capacity with metrics on the portal. Vous devez ensuite vérifier que la capacité est consommée de manière équilibrée entre toutes les partitions sous-jacentes.Then you need to ensure capacity is consumed nearly equally across all underlying partitions. Si vous constatez que la plupart du débit est consommé par une seule partition, il y a une asymétrie de la charge de travail.If you see most of the throughput is consumed by one partition, you have skew of workload.

Des indicateurs de performance sont disponibles pour vous montrer l’utilisation du débit au fil des heures, jours et semaines, sur les différentes partitions, ou sous forme agrégée.Metrics are available that show you how throughput is used over hours, days, and per seven days, across partitions or in aggregate. Pour plus d’informations, consultez la section Surveillance et débogage à l’aide de métriques dans Azure Cosmos DB.For more information, see Monitoring and debugging with metrics in Azure Cosmos DB.

Les journaux de diagnostic sont expliquées dans l’article Journalisation des diagnostics Azure Cosmos DB.Diagnostic logs are explained in the Azure Cosmos DB diagnostic logging article.

La clé primaire est-elle mappée sur le concept de clé de partition d’Azure Cosmos DB ?Does the primary key map to the partition key concept of Azure Cosmos DB?

Oui, la clé de partition est utilisée pour placer l’entité au bon emplacement.Yes, the partition key is used to place the entity in right location. Dans Azure Cosmos DB, elle est utilisée pour trouver la bonne partition logique qui est stockée sur une partition physique.In Azure Cosmos DB, it's used to find right logical partition that's stored on a physical partition. Le concept de partitionnement est également expliqué dans l’article Partitionner et mettre à l’échelle dans Azure Cosmos DB.The partitioning concept is well explained in the Partition and scale in Azure Cosmos DB article. Ce qu’il faut retenir, c’est qu’une partition logique ne doit pas dépasser la limite de 10 Go aujourd’hui.The essential take away here is that a logical partition shouldn't go over the 10-GB limit today.

Que se passe-t-il lorsque je reçois une notification de « quota complet » indiquant qu’une partition est pleine ?What happens when I get a quota full" notification indicating that a partition is full?

Azure Cosmos DB est un système basé sur un contrat de niveau de service (SLA) permettant une mise à l’échelle illimitée, avec des garanties en matière de latence, de débit, de disponibilité et de cohérence.Azure Cosmos DB is a SLA-based system that provides unlimited scale, with guarantees for latency, throughput, availability, and consistency. Cet espace de stockage illimité est basé sur un scale-out horizontal des données utilisant le partitionnement comme concept principal.This unlimited storage is based on horizontal scale out of data using partitioning as the key concept. Le concept de partitionnement est également expliqué dans l’article Partitionner et mettre à l’échelle dans Azure Cosmos DB.The partitioning concept is well explained in the Partition and scale in Azure Cosmos DB article.

Limite de 10 Go sur le nombre d’entités ou d’éléments par partition logique que vous devez respecter.The 10-GB limit on the number of entities or items per logical partition you should adhere to. Pour vous assurer que la mise à l’échelle de votre application fonctionne correctement, nous vous recommandons de ne pas créer de partition sensible en stockant toutes les informations dans une seule partition et en interrogeant celle-ci.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. Cette erreur ne se produit qu’en cas de données asymétriques, c’est-à-dire que vous avez trop de données pour une seule clé de partition (plus de 10 Go).This error can only come if your data is skewed: that is, you have lot of data for one partition key (more than 10 GB). Vous pouvez consulter la répartition des données sur le portail de stockage.You can find the distribution of data using the storage portal. Pour corriger cette erreur, vous pouvez recréer la table et choisir une clé principale granulaire (clé de partition), qui permet une meilleure répartition des données.Way to fix this error is to recreate the table and choose a granular primary (partition key), which allows better distribution of data.

Est-il possible d’utiliser l’API Cassandra en tant que stockage de valeurs de clé avec des millions, voire des milliards de clés de partition individuelles ?Is it possible to use Cassandra API as key value store with millions or billions of individual partition keys?

Azure Cosmos DB peut stocker des données illimitées en effectuant un scale-out du stockage.Azure Cosmos DB can store unlimited data by scaling out the storage. Ceci est indépendant du débit.This is independent of the throughput. Oui vous pouvez toujours utiliser l’API Cassandra pour stocker et récupérer des clés/valeurs en spécifiant la bonne clé primaire/de partition.Yes you can always just use Cassandra API to store and retrieve key/values by specifying right primary/partition key. Ces clés individuelles obtiennent leur propre partition logique et résident sur une partition physique sans problème.These individual keys get their own logical partition and sit atop physical partition without issues.

Est-il possible de créer plus d’une table avec l’API Apache Cassandra d’Azure Cosmos DB ?Is it possible to create more than one table with Apache Cassandra API of Azure Cosmos DB?

Oui, il est possible de créer plus d’une table avec l’API Apache Cassandra.Yes, it's possible to create more than one table with Apache Cassandra API. Chacune de ces tables est traitée en tant qu’unité de débit et de stockage.Each of those tables is treated as unit for throughput and storage.

Est-il possible de créer plus d’une table successivement ?Is it possible to create more than one table in succession?

Azure Cosmos DB est un système de gouvernance des ressources pour les activités liées au plan de données et au plan de contrôle.Azure Cosmos DB is resource governed system for both data and control plane activities. Les conteneurs comme les collections et les tables sont des entités de runtime qui sont provisionnées pour une certaine capacité de débit.Containers like collections, tables are runtime entities that are provisioned for given throughput capacity. La création de ces conteneurs en succession rapide n’est pas une activité prévue et est limitée.The creation of these containers in quick succession isn't expected activity and throttled. Si vous avez des tests qui suppriment/créent des tables immédiatement, essayez de les espacer.If you have tests that drop/create tables immediately, try to space them out.

Quel est le nombre maximal de tables qu’il est possible de créer ?What is maximum number of tables that can be created?

Il n’existe aucune limite physique au nombre de tables ; envoyez un e-mail à askcosmosdbcassandra@microsoft.com si vous avez un grand nombre de tables à créer (où la taille stable totale dépasse 10 To de données), au lieu des quelques dizaines ou centaines habituelles.There's no physical limit on number of tables, send an email at askcosmosdbcassandra@microsoft.com if you have large number of tables (where the total steady size goes over 10 TB of data) that need to be created from usual 10s or 100s.

Quel est le nombre maximal d’espaces de clés que nous pouvons créer ?What is the maximum # of keyspace that we can create?

Il n’existe aucune limite physique au nombre d’espaces de clés dans la mesure où il s’agit de conteneurs de métadonnées ; envoyez un e-mail à askcosmosdbcassandra@microsoft.com si, pour une raison quelconque, vous avez un grand nombre d’espaces de clés à créer.There's no physical limit on number of keyspaces as they're metadata containers, send an email at askcosmosdbcassandra@microsoft.com if you have large number of keyspaces for some reason.

Puis-je importer un volume important de données si j’ai commencé dans une table normale ?Is it possible to bring in lot of data after starting from normal table?

La capacité de stockage est gérée automatiquement et augmente à mesure que vous intégrez des données supplémentaires.The storage capacity is automatically managed and increases as you push in more data. Par conséquent, vous pouvez importer sereinement autant de données que vous le souhaitez sans avoir à gérer et provisionner des nœuds, et autres.So you can confidently import as much data as you need without managing and provisioning nodes, and more.

Puis-je fournir les paramètres du fichier yaml pour configurer le comportement de l’API Apache Casssandra d’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 d’Azure Cosmos DB est un service de plateforme.Apache Cassandra API of Azure Cosmos DB is a platform service. Elle assure la compatibilité au niveau du protocole pour l’exécution des opérations.It provides protocol level compatibility for executing operations. Elle masque la complexité des opérations de gestion, de supervision et de configuration.It hides away the complexity of management, monitoring, and configuration. En tant que développeur/utilisateur, vous n’avez pas à vous soucier de la disponibilité, des objets tombstone, du cache de clés, du cache de lignes, des filtres de Bloom et d’une multitude d’autres paramètres.As a developer/user, you don't need to worry about availability, tombstones, key cache, row cache, bloom filter, and multitude of other settings. L’API Apache Cassandra d’Azure Cosmos DB s’attache à fournir les performances en lecture et en écriture dont vous avez besoin, et ce sans la surcharge engendrée par la configuration et la gestion.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 pour Azure Cosmos DB prend-elle en charge les commandes d’ajout de nœuds/d’état du cluster/d’état du nœud ?Will Apache Cassandra API for Azure Cosmos DB support node addition/cluster status/node status commands?

L’API Apache Cassandra est un service de plateforme qui simplifie le processus de planification de la capacité et celui de réponse aux demandes d’élasticité pour le débit et le stockage.Apache Cassandra API is a platform service that makes capacity planning, responding to the elasticity demands for throughput & storage a breeze. Azure Cosmos DB provisionne le débit dont vous avez besoin.With Azure Cosmos DB you provision throughput, you need. Vous pouvez ensuite augmenter ou réduire le débit autant de fois par jour que vous le souhaitez, sans vous soucier des tâches d’ajout, de suppression ou de gestion des nœuds.Then you can scale it up and down any number of times through the day without worrying about adding/deleting nodes or managing them. Cela implique que vous n’avez pas besoin d’utiliser l’outil de gestion des clusters et des nœuds.This implies you don't need to use the node, cluster management tool too.

Qu’en est-il des différents paramètres de configuration relatifs à la création des espaces clés (simple/réseau) ?What happens with respect to various config settings for keyspace creation like simple/network?

Azure Cosmos DB offre des fonctionnalités de distribution mondiale prêtes à l’emploi à haute disponibilité et faible latence.Azure Cosmos DB provides global distribution out of the box for availability and low latency reasons. Vous n’avez pas besoin de configurer des réplicas ou d’autres choses.You don't need to setup replicas or other things. Toutes les écritures sont toujours durablement quorum validée dans n’importe quelle région où vous écrivez tout en offrant des garanties de performances.All writes are always durably quorum committed in any region where you write while providing performance guarantees.

Qu’en est-il des différents paramètres relatifs aux métadonnées de table, comme le filtre de Bloom, la mise en cache, le changement de réparation des lectures, la période de grâce du garbage collection et la période de vidage des memtables pour la compression, et autres ?What happens with respect to various settings for table metadata like bloom filter, caching, read repair change, gc_grace, compression memtable_flush_period, and more?

Azure Cosmos DB offre des performances en termes de débit et d’opérations en lecture/écriture, sans aucun changement à apporter aux paramètres de configuration, ce qui réduit les risques liés à toute manipulation accidentelle.Azure Cosmos DB provides performance for reads/writes and throughput without need for touching any of the configuration settings and accidentally manipulating them.

Les tables Cassandra prennent-elles en charge la durée de vie (TTL) ?Is time-to-live (TTL) supported for Cassandra tables?

Oui, TTL est pris en charge.Yes, TTL is supported.

Est-il possible de surveiller l’état du nœud, l’état du réplica, le garbage collection et les paramètres du système d’exploitation en amont avec différents outils ?Is it possible to monitor node status, replica status, gc, and OS parameters earlier with various tools? Quels éléments sont dorénavant à surveiller ?What needs to be monitored now?

Azure Cosmos DB est un service de plateforme qui vous permet d’augmenter votre productivité sans vous soucier des opérations de gestion et de surveillance de l’infrastructure.Azure Cosmos DB is a platform service that helps you increase productivity and not worry about managing and monitoring infrastructure. Vous devez simplement vous soucier du débit relevé dans les indicateurs de performance accessibles sur le portail, pour vérifier si vous approchez de la limite et devez augmenter ou réduire ce débit en conséquence.You just need to take care of throughput that's available on portal metrics to find if you're getting throttled and increase or decrease that throughput. Analyser les contrats de niveau de serviceMonitor SLAs. Utiliser les indicateurs de performance Utiliser les journaux de diagnostic.Use Metrics Use Diagnostic logs.

Quels sont les kits SDK clients qui fonctionnent avec l’API Apache Cassandra d’Azure Cosmos DB ?Which client SDKs can work with Apache Cassandra API of Azure Cosmos DB?

Les pilotes clients Apache Cassandra du Kit de développement qui utilisent CQLv3 ont été utilisées pour les programmes clients.Apache Cassandra SDK's client drivers that use CQLv3 were used for client programs. Si vous utilisez d’autres pilotes ou si vous rencontrez des difficultés, envoyez un e-mail à l’adresse askcosmosdbcassandra@microsoft.com.If you have other drivers that you use or if you're facing issues, send mail to askcosmosdbcassandra@microsoft.com.

Les clés de partition composites sont-elles prises en charge ?Is composite partition key supported?

Oui, vous pouvez utiliser la syntaxe régulière pour créer une clé de partition composite.Yes, you can use regular syntax to create composite partition key.

Puis-je utiliser le chargeur stable pour le chargement des données ?Can I use stable loader for data loading?

Non, en préversion, le chargeur stable n’est pas pris en charge.No, during preview stable loader isn't supported.

Un cluster de Apache Cassandra sur site peut être jumelé avec l’API Cassandra Azure Cosmos DB ?Can an on-premises Apache Cassandra cluster be paired with Azure Cosmos DB's Cassandra API?

Actuellement, Azure Cosmos DB offre une expérience optimisée pour l’environnement cloud, sans la surcharge engendrée par les opérations.At present Azure Cosmos DB has an optimized experience for cloud environment without overhead of operations. Si vous avez besoin de procéder à une association, envoyez un e-mail à l’adresse askcosmosdbcassandra@microsoft.com avec une description de votre scénario.If you require pairing, send mail to askcosmosdbcassandra@microsoft.com with a description of your scenario.

L’API Cassandra fournit-elle des sauvegardes complètes ?Does Cassandra API provide full backups?

Azure Cosmos DB réalise actuellement deux sauvegardes complètes gratuites toutes les quatre heures, sur toutes les API.Azure Cosmos DB provides two free full backups taken at four hours interval today across all APIs. Il est donc inutile de configurer une planification de sauvegarde ou d’autres choses.This ensures you don't need to set up a backup schedule and other things. Si vous souhaitez modifier la rétention et la fréquence, envoyez un e-mail à l’adresse askcosmosdbcassandra@microsoft.com ou soumettez une demande d’assistance.If you want to modify retention and frequency, send an email to askcosmosdbcassandra@microsoft.com or raise a support case. Pour en savoir plus sur la fonctionnalité de sauvegarde, consultez l’article Sauvegarde et restauration en ligne automatiques avec Azure Cosmos DB.Information about backup capability is provided in the Automatic online backup and restore with Azure Cosmos DB article.

Comment le compte d’API Cassandra gère-t-il le basculement en cas de défaillance d’une région ?How does the Cassandra API account handle failover if a region goes down?

L’API Cassandra d’Azure Cosmos DB utilise la plateforme distribuée mondialement d’Azure Cosmos DB.The Azure Cosmos DB Cassandra API borrows from the globally distributed platform of Azure Cosmos DB. Pour vous assurer que votre application peut tolérer des temps d’arrêt de centre de données, activez au moins une région supplémentaire pour le compte dans le portail Azure Cosmos DB (voir Développement avec des comptes Azure Cosmos DB multirégions).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. Vous pouvez définir la priorité de la région à l’aide du portail (voir Developing with multi-region Azure Cosmos DB accounts (Développement avec des comptes Azure Cosmos DB multirégions)).You can set the priority of the region by using the portal Developing with multi-region Azure Cosmos DB accounts.

Vous pouvez ajouter autant de régions que vous le souhaitez pour le compte, et contrôler l’emplacement de basculement en indiquant une priorité.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. Pour utiliser la base de données, vous devez également fournir une application à cet emplacement.To use the database, you need to provide an application there too. Si vous procédez de la sorte, vos clients ne subissent aucun temps d’arrêt.When you do so, your customers won't experience downtime.

L’API Apache Cassandra indexe-t-elle par défaut tous les attributs d’une entité ?Does the Apache Cassandra API index all attributes of an entity by default?

Oui, tous les attributs d’une entité sont indexés par défaut par Azure Cosmos DB.Yes, all attributes of an entity are indexed by default by Azure Cosmos DB. Pour plus d’informations, voir Azure Cosmos DB : Stratégies d’indexation.For more information, see Azure Cosmos DB: Indexing policies. Vous bénéficiez de performances garanties avec une indexation cohérente et des écritures durables toujours validées dans un quorum.You get benefits of guaranteed performance with consistent indexing and durable quorum committed writes always.

Cela signifie-t-il que je n’ai pas besoin de créer plusieurs index pour satisfaire les requêtes ?Does this mean I don't have to create more than one index to satisfy the queries?

Oui, Azure Cosmos DB assure l’indexation automatique de tous les attributs sans aucune définition de schéma.Yes, Azure Cosmos DB provides automatic indexing of all attributes without any schema definition. Cette automatisation permet aux développeurs de se concentrer sur l’application plutôt que sur la création et la gestion d’index.This automation frees developers to focus on the application rather than on index creation and management. Pour plus d’informations, voir Azure Cosmos DB : Stratégies d’indexation.For more information, see Azure Cosmos DB: Indexing policies.

Puis-je utiliser le nouveau kit SDK de l’API Cassandra localement avec l’émulateur ?Can I use the new Cassandra API SDK locally with the emulator?

Nous prévoyons de prendre en charge de cette fonctionnalité à l’avenir.We plan to support this capability in future.

Azure Cosmos DB en tant que plateforme semble offrir de nombreuses fonctionnalités, telles que les flux de modification et d’autres fonctionnalités.Azure Cosmos DB as a platform seems to have lot of capabilities, such as change feed and other functionality. Ces fonctionnalités seront-elles ajoutées à l’API Cassandra ?Will these capabilities be added to the Cassandra API?

L’API Apache Cassandra fournit les mêmes fonctionnalités CQL qu’Apache Cassandra.The Apache Cassandra API provides the same CQL functionality as Apache Cassandra. Nous envisageons effectivement d’étudier la possibilité de prendre en charge d’autres fonctionnalités à l’avenir.We do plan to look into feasibility of supporting various capabilities in future.

La fonctionnalité x de l’API Cassandra normale ne fonctionne pas pour le moment. Où puis-je adresser mes commentaires ?Feature x of regular Cassandra API isn't working as today, where can the feedback be provided?

Partagez vos commentaires via les commentaires user voice.Provide feedback via user voice feedback.