@azure/cosmos package

Cette erreur est levée lorsqu’une opération asynchrone a été abandonnée. Vérifiez cette erreur en testant l'name que la propriété name de l’erreur correspond à "AbortError".

exemple de

const controller = new AbortController();
controller.abort();
try {
  doAsyncWork(controller.signal)
} catch (e) {
  if (e.name === 'AbortError') {
    // handle abort error here.
  }
}

Fournit un itérateur pour le flux de modification.

Utilisez Items.changeFeed() pour obtenir une instance de l’itérateur.

Page de réponse unique du flux de modification Azure Cosmos DB

Représente la configuration de la stratégie de flux de modification pour un conteneur dans le service Azure Cosmos DB.

Page de réponse unique du flux de modification Azure Cosmos DB

Classe de base pour l’emplacement de démarrage d’un ChangeFeedIterator.

Permet de lire ou de supprimer un conflit donné par ID.

Consultez conflits pour interroger ou lire tous les conflits.

Permet d’interroger ou de lire tous les conflits.

Consultez conflit pour lire ou supprimer un conflit donné par ID.

Opérations de lecture, de remplacement ou de suppression d’un conteneur spécifique existant par ID.

Consultez conteneurs pour créer de nouveaux conteneurs et lire/interroger tous les conteneurs ; utilisez .containers.

Remarque : toutes ces opérations effectuent des appels sur un budget fixe. Vous devez concevoir votre système afin que ces appels soient mis à l’échelle sous-linéairement avec votre application. Par exemple, n’appelez pas container(id).read() avant chaque appel de item.read() unique, pour vous assurer que le conteneur existe ; effectuez cette opération une fois sur le démarrage de l’application.

Objet Response pour les opérations de conteneur

Opérations de création de nouveaux conteneurs et lecture/interrogation de tous les conteneurs

Consultez conteneur pour la lecture, le remplacement ou la suppression d’un conteneur existant ; utilisez .container(id).

Remarque : toutes ces opérations effectuent des appels sur un budget fixe. Vous devez concevoir votre système afin que ces appels soient mis à l’échelle sous-linéairement avec votre application. Par exemple, n’appelez pas containers.readAll() avant chaque appel de item.read() unique, pour vous assurer que le conteneur existe ; effectuez cette opération une fois sur le démarrage de l’application.

Fournit une représentation logique côté client du compte de base de données Azure Cosmos DB. Ce client est utilisé pour configurer et exécuter des requêtes dans le service de base de données Azure Cosmos DB.

exemple de

Instancier un client et créer une base de données

const client = new CosmosClient({endpoint: "<URL HERE>", key: "<KEY HERE>"});
await client.databases.create({id: "<database name here>"});

exemple de

Instancier un client avec une stratégie de connexion personnalisée

const client = new CosmosClient({
   endpoint: "<URL HERE>",
   key: "<KEY HERE>",
   connectionPolicy: {
    requestTimeout: 10000,
   },
});

• Il s’agit d’un type de diagnostic Cosmos qui contient les informations de diagnostic collectées pendant les opérations du client. Ie. Item.read(), Container.create(). Il a trois membres -

1. clientSideRequestStatistics membre contient des informations de diagnostic agrégées, notamment :

• recherches de métadonnées. Ici, toutes les demandes de serveur, en dehors de la ressource finale prévue sont considérées comme des appels de métadonnées. Par exemple, pour item.read(id), si le client effectue un appel de serveur pour découvrir les points de terminaison, il serait considéré comme un appel de métadonnées.
• Tentatives
• points de terminaison contactés.
• statistiques de la charge utile de la requête, de la réponse.
• gatewayStatistics : informations correspondant à l’opération principale. Par exemple, pendant Item.read(), le client peut effectuer de nombreuses opérations, c’est-à-dire la recherche de métadonnées, etc. mais gatewayStatistics représente les informations de diagnostic pour l’opération de lecture réelle.

2. diagnosticNode : arborescence semblable à une structure qui capture des informations de diagnostic détaillées. Par défaut, il est désactivé et est destiné à être utilisé uniquement pour le débogage sur des environnements non de production. Le type de détails capturés dans diagnosticNode est contrôlé par CosmosDbDiagnosticLevel.

• CosmosDbDiagnosticLevel.info : valeur par défaut. Dans ce niveau, seuls clientSideRequestStatistics sont capturés. Est destiné aux environnements de production.
• CosmosDbDiagnosticLevel.debug - Captures diagnosticNode et clientConfig. Aucune charge utile de requête et de réponse n’est capturée. N’est pas destiné à être utilisé dans l’environnement de production.
• CosmosDbDiagnosticLevel.debug-unsafe : en plus des données capturées dans CosmosDbDiagnosticLevel.debug, capture également les charges utiles de requête et de réponse. N’est pas destiné à être utilisé dans l’environnement de production.

3. clientConfig : capture des informations relatives à la façon dont le client a été configuré lors de l’initialisation.

Opérations de lecture ou de suppression d’une base de données existante.

Consultez bases de données pour créer de nouvelles bases de données et lire/interroger toutes les bases de données ; utilisez client.databases.

Remarque : toutes ces opérations effectuent des appels sur un budget fixe. Vous devez concevoir votre système afin que ces appels soient mis à l’échelle sous-linéairement avec votre application. Par exemple, n’appelez pas database.read() avant chaque appel de item.read() unique, pour vous assurer que la base de données existe ; effectuez cette opération une fois sur le démarrage de l’application.

Représente un DatabaseAccount dans le service de base de données Azure Cosmos DB.

Objet Response pour les opérations de base de données

Opérations de création de bases de données et lecture/interrogation de toutes les bases de données

Consultez base de données pour lire ou supprimer une base de données existante ; utilisez client.database(id).

Remarque : toutes ces opérations effectuent des appels sur un budget fixe. Vous devez concevoir votre système afin que ces appels soient mis à l’échelle sous-linéairement avec votre application. Par exemple, n’appelez pas databases.readAll() avant chaque appel de item.read() unique, pour vous assurer que la base de données existe ; effectuez cette opération une fois sur le démarrage de l’application.

Spécifie une plage de flux pour le flux de modification.

Permet d’effectuer des opérations sur un élément spécifique.

Consultez éléments pour les opérations sur tous les éléments ; voir container.items.

Opérations de création d’éléments et lecture/interrogation de tous les éléments

Consultez d’élément pour la lecture, le remplacement ou la suppression d’un conteneur existant ; utilisez .item(id).

Permet de lire ou de remplacer une offre existante par ID.

Consultez offres pour interroger ou lire toutes les offres.

Permet d’interroger ou de lire toutes les offres.

Consultez d’offre pour lire ou remplacer un d’offre existant par ID.

Classe Builder pour la génération de PartitionKey.

Permet de lire, remplacer ou supprimer un autorisation donné par ID.

Consultez autorisations pour créer, upsert, interroger ou lire toutes les autorisations.

Permet de créer, remplacer, interroger et lire toutes les autorisations.

Consultez d’autorisation pour lire, remplacer ou supprimer une autorisation spécifique par ID.

Représente un objet QueryIterator, une implémentation de flux ou de réponse de requête qui permet une traversée et une itération sur la réponse dans le service de base de données Azure Cosmos DB.

Type d’erreur personnalisé pour les demandes de pipeline ayant échoué.

Opérations de lecture, de remplacement, de suppression ou d’exécution d’une procédure stockée existante spécifique par ID.

Pour que les opérations créent, lisent toutes ou interrogent des procédures stockées,

Opérations de création, d’upserting ou de lecture/interrogation de toutes les procédures stockées.

Pour que les opérations de lecture, de remplacement, de suppression ou d’exécution d’une procédure stockée spécifique, existante par ID, voir container.storedProcedure().

Opérations de lecture, de remplacement ou de suppression d’un déclencheur .

Utilisez container.triggers pour créer, upsert, interroger ou lire tout.

Opérations de création, upsert, requête et lecture de tous les déclencheurs.

Utilisez pour lire, remplacer ou supprimer undéclencheur .

Utilisé pour lire, remplacer et supprimer des utilisateurs.

En outre, vous pouvez accéder aux autorisations d’un utilisateur donné via user.permission et user.permissions.

Consultez Utilisateurs pour créer, upsert, interroger ou lire tout.

Utilisé pour lire, remplacer ou supprimer une fonction définie par id.

Consultez UserDefinedFunction pour créer, upsert, interroger, lire toutes les fonctions définies par l’utilisateur.

Utilisé pour créer, upsert, interroger ou lire toutes les fonctions définies par l’utilisateur.

Consultez UserDefinedFunction pour lire, remplacer ou supprimer une fonction définie par l’utilisateur donnée par ID.

Utilisé pour créer, upsert, interroger et lire tous les utilisateurs.

Consultez 'utilisateur pour lire, remplacer ou supprimer un utilisateur spécifique par ID.

Objet Options utilisé pour modifier l’exécution en bloc. continueOnError (valeur par défaut : false) : poursuit l’exécution en bloc lorsqu’une opération échoue ** REMARQUE QUE LA valeur PAR DÉFAUT EST TRUE DANS la version 4.0 RELEASE

Spécifie les options du flux de modification

Si aucune de ces options n’est définie, elle commence à lire les modifications à partir de maintenant pour l’ensemble du conteneur.

Spécifie les options du flux de modification

Certaines de ces options contrôlent où et quand commencer la lecture à partir du flux de modification. L’ordre de priorité est le suivant :

• continuation
• startTime
• startFromBeginning

Si aucune de ces options n’est définie, elle commence à lire les modifications de la première ChangeFeedIterator.fetchNext() appel.

Utilisez Items.getChangeFeedIterator() pour retourner un itérateur qui peut itérer sur toutes les modifications d’une clé de partition, d’une plage de flux ou d’un conteneur entier.

Représente un chemin composite dans la stratégie d’indexation.

Représente la configuration de la stratégie de résolution des conflits pour spécifier comment résoudre les conflits au cas où les écritures à partir de différentes régions entraînent des conflits sur les documents de la collection dans le service Azure Cosmos DB.

Représente la stratégie de connexion associée à un CosmosClient dans le service de base de données Azure Cosmos DB.

Représente une arborescence telle que la structure, pour capturer les informations de diagnostic.

Ce type capture les informations de diagnostic relatives à une requête ayant échoué à l’API serveur.

Options de flux et méthodes de requête.

Les éléments dans Cosmos DB sont simplement des objets JSON. La plupart des opérations Item permettent à vous de fournir votre propre type qui étend la très simple ItemDefinition.

Vous ne pouvez pas utiliser de clés réservées. Vous pouvez voir la liste des clés réservées dans <xref:ItemBody>

Utilisé pour spécifier les emplacements disponibles, la lecture est l’index 1 et l’écriture est l’index 0.

Ce type contient des informations de diagnostic concernant une demande de métadonnées unique au serveur.

Options qui peuvent être spécifiées pour une demande émise sur les serveurs Azure Cosmos DB.=

Représente la stratégie de nouvelle tentative assocée avec des requêtes limitées dans le service de base de données Azure Cosmos DB.

Options qui peuvent être spécifiées pour une demande émise sur les serveurs Azure Cosmos DB.=

Représente un paramètre dans une requête SQL paramétrable, spécifiée dans SqlQuerySpec

Représente une requête SQL dans le service Azure Cosmos DB.

Les requêtes avec entrées doivent être paramétrées pour se protéger contre l’injection SQL.

exemple de

Requête SQL paramétrée

const query: SqlQuerySpec = {
  query: "SELECT * FROM Families f where f.lastName = @lastName",
  parameters: [
    {name: "@lastName", value: "Wakefield"}
  ]
};

Interface pour une clé unique passée dans le cadre de UniqueKeyPolicy

Interface permettant de définir des clés uniques lors de la création d’un conteneur

Représente un incorporation vectorielle. Une incorporation de vecteurs est utilisée pour définir un champ vectoriel dans les documents.

Représente la configuration de stratégie pour les incorporations vectorielles dans le service Azure Cosmos DB.

Représente un index vectoriel dans le service Azure Cosmos DB. Un index vectoriel est utilisé pour indexer des champs vectoriels dans les documents.

Ce type contient des informations relatives à l’initialisation de CosmosClient

Il s’agit d’un type de collection pour toutes les informations de diagnostic côté client.

Ce type contient des informations de diagnostic concernant toutes les requêtes de métadonnées adressées au serveur pendant une opération cliente CosmosDB.

L’objet retourné représente une valeur de clé de partition qui permet de créer et d’accéder aux éléments sans valeur pour la clé de partition

L’objet retourné représente une valeur de clé de partition qui permet de créer et d’accéder aux éléments avec une valeur Null pour la clé de partition.

PartitionKey d’un conteneur.

Valeur de clé de partition primitive.

Ce type capture les informations de diagnostic relatives aux nouvelles tentatives lors d’une opération cliente CosmosDB.

Détermine le comportement de connexion du CosmosClient. Notez que nous prenons uniquement en charge le mode passerelle.

Représente les niveaux de cohérence pris en charge pour les opérations du client Azure Cosmos DB.
La valeur ConsistencyLevel demandée doit correspondre ou être plus faible que celle configurée pour le compte de base de données. Niveaux de cohérence.

Les niveaux de cohérence par ordre de force sont Forts, BoundedStaleness, Session, Préfixe cohérent et Final.

Consultez https://aka.ms/cosmos-consistency pour obtenir une documentation plus détaillée sur les niveaux de cohérence.

Niveau de diagnostic Cosmos DB

Définit un type de données cible d’une spécification de chemin d’index dans le service Azure Cosmos DB.

Spécifie les types d’index pris en charge.

Spécifie les modes d’indexation pris en charge.

Il s’agit de l’énumération pour le type de recherche de métadonnées possible.

Version de la définition partitionKey

Type de PartitionKey, c’est-à-dire hachage, MultiHash

Énumération pour les valeurs du mode d’autorisation.

Représente le niveau de priorité associé à chaque demande de client Azure Cosmos DB.
Les requêtes de faible priorité sont toujours limitées avant toutes les demandes de priorité élevée.

Par défaut, toutes les requêtes sont considérées comme des requêtes de priorité élevée.

Consultez https://aka.ms/CosmosDB/PriorityBasedExecution pour obtenir une documentation plus détaillée sur la limitation basée sur la priorité.

Énumération pour les valeurs d’opération de déclencheur. spécifie les opérations sur lesquelles un déclencheur doit être exécuté.

Énumération pour les valeurs de type de déclencheur. Spécifie le type du déclencheur.

Énumération pour les valeurs de type udf. Spécifie les types de fonctions définies par l’utilisateur.

Représente le type de données du vecteur.

Représente la fonction de distance à utiliser pour le calcul de distance entre les vecteurs.

Représente le type d’index du vecteur.

L’interne expérimental génère uniquement la charge utile représentant la configuration d’autorisation pour le jeton sas.