Container class

Paquet:

@azure/cosmos

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.

Propriétés

conflicts	Opérations de lecture et d’interrogation de conflits pour le conteneur donné. Pour lire ou supprimer un conflit spécifique, utilisez .conflict(id).
database
id
items	Opérations de création d’éléments et lecture/interrogation de tous les éléments Pour lire, remplacer ou supprimer un élément existant, utilisez .item(id). exemple de Créer un élément const {body: createdItem} = await container.items.create({id: "<item id>", properties: {}});
scripts	Toutes les opérations pour les procédures stockées, les déclencheurs et les fonctions définies par l’utilisateur
url	Retourne une URL de référence à la ressource. Utilisé pour la liaison dans Autorisations.

Méthodes

conflict(string, PartitionKey)	Utilisé pour lire, remplacer ou supprimer un conflit existant existant par ID. Utilisez .conflicts pour créer de nouveaux conflits, ou interroger/lire tous les conflits.
delete(RequestOptions)	Supprimer le conteneur
deleteAllItemsForPartitionKey(PartitionKey, RequestOptions)	Supprimer tous les documents appartiennent au conteneur pour la valeur de clé de partition fournie
getFeedRanges()
getPartitionKeyDefinition()	Obtient d’abord la définition de clé de partition en examinant le cache autrement en lisant la collection.
getQueryPlan(string | SqlQuerySpec)
item(string, PartitionKey)	Utilisé pour lire, remplacer ou supprimer un élément existant spécifique par ID. Utilisez .items pour créer des éléments, ou interroger/lire tous les éléments. exemple de Remplacer un élément const {body: replacedItem} = await container.item("<item id>", "<partition key value>").replace({id: "<item id>", title: "Updated post", authorID: 5});
read(RequestOptions)	Lire la définition du conteneur
readOffer(RequestOptions)	Obtient l’offre sur le conteneur. S’il n’en existe aucun, retourne un OfferResponse avec undefined.
readPartitionKeyRanges(FeedOptions)
replace(ContainerDefinition, RequestOptions)	Remplacer la définition du conteneur

Détails de la propriété

conflicts

Opérations de lecture et d’interrogation de conflits pour le conteneur donné.

Pour lire ou supprimer un conflit spécifique, utilisez .conflict(id).

Conflicts conflicts

Valeur de propriété

Conflicts

database

database: Database

Valeur de propriété

Database

id

id: string

Valeur de propriété

string

items

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

Pour lire, remplacer ou supprimer un élément existant, utilisez .item(id).

exemple de

Créer un élément

const {body: createdItem} = await container.items.create({id: "<item id>", properties: {}});

Items items

Valeur de propriété

Items

scripts

Toutes les opérations pour les procédures stockées, les déclencheurs et les fonctions définies par l’utilisateur

Scripts scripts

Valeur de propriété

Scripts

url

Retourne une URL de référence à la ressource. Utilisé pour la liaison dans Autorisations.

string url

Valeur de propriété

string

Détails de la méthode

conflict(string, PartitionKey)

Utilisé pour lire, remplacer ou supprimer un conflit existant existant par ID.

Utilisez .conflicts pour créer de nouveaux conflits, ou interroger/lire tous les conflits.

function conflict(id: string, partitionKey?: PartitionKey): Conflict

Paramètres

id

string

ID du conflit.

partitionKey

PartitionKey

Retours

Conflict

delete(RequestOptions)

Supprimer le conteneur

function delete(options?: RequestOptions): Promise<ContainerResponse>

Paramètres

options

RequestOptions

Retours

Promise<ContainerResponse>

deleteAllItemsForPartitionKey(PartitionKey, RequestOptions)

Supprimer tous les documents appartiennent au conteneur pour la valeur de clé de partition fournie

function deleteAllItemsForPartitionKey(partitionKey: PartitionKey, options?: RequestOptions): Promise<ContainerResponse>

Paramètres

partitionKey

PartitionKey

Valeur de clé de partition des éléments à supprimer

options

RequestOptions

Retours

Promise<ContainerResponse>

getFeedRanges()

function getFeedRanges(): Promise<readonly FeedRange[]>

Retours

Promise<readonly FeedRange[]>

toutes les plages de flux pour lesquelles le flux de modification peut être récupéré.

getPartitionKeyDefinition()

Avertissement

Cette API est à présent déconseillée.

This method has been renamed to readPartitionKeyDefinition.

Obtient d’abord la définition de clé de partition en examinant le cache autrement en lisant la collection.

function getPartitionKeyDefinition(): Promise<ResourceResponse<PartitionKeyDefinition>>

Retours

Promise<ResourceResponse<PartitionKeyDefinition>>

getQueryPlan(string | SqlQuerySpec)

function getQueryPlan(query: string | SqlQuerySpec): Promise<Response_2<PartitionedQueryExecutionInfo>>

Paramètres

query

string | SqlQuerySpec

Retours

Promise<Response_2<PartitionedQueryExecutionInfo>>

item(string, PartitionKey)

Utilisé pour lire, remplacer ou supprimer un élément existant spécifique par ID.

Utilisez .items pour créer des éléments, ou interroger/lire tous les éléments.

exemple de

Remplacer un élément const {body: replacedItem} = await container.item("<item id>", "<partition key value>").replace({id: "<item id>", title: "Updated post", authorID: 5});

function item(id: string, partitionKeyValue?: PartitionKey): Item

Paramètres

id

string

ID de l’élément .

partitionKeyValue

PartitionKey

Valeur de la clé de partition Élément

Retours

Item

read(RequestOptions)

Lire la définition du conteneur

function read(options?: RequestOptions): Promise<ContainerResponse>

Paramètres

options

RequestOptions

Retours

Promise<ContainerResponse>

readOffer(RequestOptions)

Obtient l’offre sur le conteneur. S’il n’en existe aucun, retourne un OfferResponse avec undefined.

function readOffer(options?: RequestOptions): Promise<OfferResponse>

Paramètres

options

RequestOptions

Retours

Promise<OfferResponse>

readPartitionKeyRanges(FeedOptions)

function readPartitionKeyRanges(feedOptions?: FeedOptions): QueryIterator<PartitionKeyRange>

Paramètres

feedOptions

FeedOptions

Retours

QueryIterator<PartitionKeyRange>

replace(ContainerDefinition, RequestOptions)

Remplacer la définition du conteneur

function replace(body: ContainerDefinition, options?: RequestOptions): Promise<ContainerResponse>

Paramètres

body

ContainerDefinition

options

RequestOptions

Retours

Promise<ContainerResponse>