Partager via

Items class

  • Référence
Paquet:
@azure/cosmos

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).

Propriétés

container

Méthodes

batch(OperationInput[], PartitionKey, RequestOptions)

Exécutez des opérations de traitement par lots transactionnelles sur des éléments.

Batch prend un tableau d’opérations qui sont typées en fonction de ce que fait l’opération. Batch est transactionnel et restaure toutes les opérations en cas d’échec. Les choix sont les suivants : Créer, Upsert, Lire, Remplacer et Supprimer

Exemple d’utilisation :

// The partitionKey is a required second argument. If it’s undefined, it defaults to the expected partition key format.
const operations: OperationInput[] = [
   {
      operationType: "Create",
      resourceBody: { id: "doc1", name: "sample", key: "A" }
   },
   {
      operationType: "Upsert",
      resourceBody: { id: "doc2", name: "other", key: "A" }
   }
]

await database.container.items.batch(operations, "A")
bulk(OperationInput[], BulkOptions, RequestOptions)

Exécutez des opérations en bloc sur des éléments.

Prend en bloc un tableau d’opérations qui sont typées en fonction de ce que fait l’opération. Les choix sont les suivants : Créer, Upsert, Lire, Remplacer et Supprimer

Exemple d’utilisation :

// partitionKey is optional at the top level if present in the resourceBody
const operations: OperationInput[] = [
   {
      operationType: "Create",
      resourceBody: { id: "doc1", name: "sample", key: "A" }
   },
   {
      operationType: "Upsert",
      partitionKey: 'A',
      resourceBody: { id: "doc2", name: "other", key: "A" }
   }
]

await database.container.items.bulk(operations)
changeFeed(ChangeFeedOptions)

Créer un ChangeFeedIterator pour itérer sur les pages de modifications
changeFeed(PartitionKey, ChangeFeedOptions)

Créer un ChangeFeedIterator pour itérer sur les pages de modifications

exemple de

Lisez à partir du début du flux de modification.

const iterator = items.readChangeFeed({ startFromBeginning: true });
const firstPage = await iterator.fetchNext();
const firstPageResults = firstPage.result
const secondPage = await iterator.fetchNext();
changeFeed<T>(ChangeFeedOptions)

Créer un ChangeFeedIterator pour itérer sur les pages de modifications
changeFeed<T>(PartitionKey, ChangeFeedOptions)

Créer un ChangeFeedIterator pour itérer sur les pages de modifications
create<T>(T, RequestOptions)

Créez un élément.

Tout type fourni, T, n’est pas nécessairement appliqué par le Kit de développement logiciel (SDK). Vous pouvez obtenir plus ou moins de propriétés et il est à votre logique de l’appliquer.

Il n’existe aucun schéma défini pour les éléments JSON. Ils peuvent contenir n’importe quel nombre de propriétés personnalisées.
getChangeFeedIterator<T>(ChangeFeedIteratorOptions)

Retourne un itérateur pour itérer sur les pages de modifications. L’itérateur retourné peut être utilisé pour extraire les modifications d’une clé de partition unique, d’une plage de flux ou d’un conteneur entier.
query(string | SqlQuerySpec, FeedOptions)

Interroge tous les éléments.

exemple de

Lire tous les éléments dans le tableau.

const querySpec: SqlQuerySpec = {
  query: "SELECT * FROM Families f WHERE f.lastName = @lastName",
  parameters: [
    {name: "@lastName", value: "Hendricks"}
  ]
};
const {result: items} = await items.query(querySpec).fetchAll();
query<T>(string | SqlQuerySpec, FeedOptions)

Interroge tous les éléments.

exemple de

Lire tous les éléments dans le tableau.

const querySpec: SqlQuerySpec = {
  query: "SELECT firstname FROM Families f WHERE f.lastName = @lastName",
  parameters: [
    {name: "@lastName", value: "Hendricks"}
  ]
};
const {result: items} = await items.query<{firstName: string}>(querySpec).fetchAll();
readAll(FeedOptions)

Lisez tous les éléments.

Il n’existe aucun schéma défini pour les éléments JSON. Ils peuvent contenir n’importe quel nombre de propriétés personnalisées.

exemple de

Lire tous les éléments dans le tableau.

const {body: containerList} = await items.readAll().fetchAll();
readAll<T>(FeedOptions)

Lisez tous les éléments.

Tout type fourni, T, n’est pas nécessairement appliqué par le Kit de développement logiciel (SDK). Vous pouvez obtenir plus ou moins de propriétés et il est à votre logique de l’appliquer.

Il n’existe aucun schéma défini pour les éléments JSON. Ils peuvent contenir n’importe quel nombre de propriétés personnalisées.

exemple de

Lire tous les éléments dans le tableau.

const {body: containerList} = await items.readAll().fetchAll();
readChangeFeed(ChangeFeedOptions)

Créer un ChangeFeedIterator pour itérer sur les pages de modifications
readChangeFeed(PartitionKey, ChangeFeedOptions)

Créer un ChangeFeedIterator pour itérer sur les pages de modifications

exemple de

Lisez à partir du début du flux de modification.

const iterator = items.readChangeFeed({ startFromBeginning: true });
const firstPage = await iterator.fetchNext();
const firstPageResults = firstPage.result
const secondPage = await iterator.fetchNext();
readChangeFeed<T>(ChangeFeedOptions)

Créer un ChangeFeedIterator pour itérer sur les pages de modifications
readChangeFeed<T>(PartitionKey, ChangeFeedOptions)

Créer un ChangeFeedIterator pour itérer sur les pages de modifications
upsert(unknown, RequestOptions)

Upsert un élément.

Il n’existe aucun schéma défini pour les éléments JSON. Ils peuvent contenir n’importe quel nombre de propriétés personnalisées.
upsert<T>(T, RequestOptions)

Upsert un élément.

Tout type fourni, T, n’est pas nécessairement appliqué par le Kit de développement logiciel (SDK). Vous pouvez obtenir plus ou moins de propriétés et il est à votre logique de l’appliquer.

Il n’existe aucun schéma défini pour les éléments JSON. Ils peuvent contenir n’importe quel nombre de propriétés personnalisées.

Détails de la propriété

container 

container: Container

Valeur de propriété

Container

Détails de la méthode

batch(OperationInput[], PartitionKey, RequestOptions)

Exécutez des opérations de traitement par lots transactionnelles sur des éléments.

Batch prend un tableau d’opérations qui sont typées en fonction de ce que fait l’opération. Batch est transactionnel et restaure toutes les opérations en cas d’échec. Les choix sont les suivants : Créer, Upsert, Lire, Remplacer et Supprimer

Exemple d’utilisation :

// The partitionKey is a required second argument. If it’s undefined, it defaults to the expected partition key format.
const operations: OperationInput[] = [
   {
      operationType: "Create",
      resourceBody: { id: "doc1", name: "sample", key: "A" }
   },
   {
      operationType: "Upsert",
      resourceBody: { id: "doc2", name: "other", key: "A" }
   }
]

await database.container.items.batch(operations, "A")

function batch(operations: OperationInput[], partitionKey?: PartitionKey, options?: RequestOptions): Promise<Response_2<OperationResponse[]>>

Paramètres

operations

OperationInput[]

Liste des opérations. Limite 100

partitionKey
PartitionKey
options
RequestOptions

Utilisé pour modifier la requête

Retours

Promise<Response_2<OperationResponse[]>>

bulk(OperationInput[], BulkOptions, RequestOptions)

Exécutez des opérations en bloc sur des éléments.

Prend en bloc un tableau d’opérations qui sont typées en fonction de ce que fait l’opération. Les choix sont les suivants : Créer, Upsert, Lire, Remplacer et Supprimer

Exemple d’utilisation :

// partitionKey is optional at the top level if present in the resourceBody
const operations: OperationInput[] = [
   {
      operationType: "Create",
      resourceBody: { id: "doc1", name: "sample", key: "A" }
   },
   {
      operationType: "Upsert",
      partitionKey: 'A',
      resourceBody: { id: "doc2", name: "other", key: "A" }
   }
]

await database.container.items.bulk(operations)

function bulk(operations: OperationInput[], bulkOptions?: BulkOptions, options?: RequestOptions): Promise<BulkOperationResponse>

Paramètres

operations

OperationInput[]

Liste des opérations. Limite 100

bulkOptions
BulkOptions

Objet options facultatives pour modifier le comportement en bloc. Passez { continueOnError : false } pour arrêter l’exécution des opérations en cas d’échec. (Valeur par défaut true)

options
RequestOptions

Utilisé pour modifier la requête.

Retours

Promise<BulkOperationResponse>

changeFeed(ChangeFeedOptions)

Créer un ChangeFeedIterator pour itérer sur les pages de modifications

function changeFeed(changeFeedOptions?: ChangeFeedOptions): ChangeFeedIterator<any>

Paramètres

changeFeedOptions
ChangeFeedOptions

Retours

ChangeFeedIterator<any>

changeFeed(PartitionKey, ChangeFeedOptions)

Créer un ChangeFeedIterator pour itérer sur les pages de modifications

exemple de

Lisez à partir du début du flux de modification.

const iterator = items.readChangeFeed({ startFromBeginning: true });
const firstPage = await iterator.fetchNext();
const firstPageResults = firstPage.result
const secondPage = await iterator.fetchNext();

function changeFeed(partitionKey: PartitionKey, changeFeedOptions?: ChangeFeedOptions): ChangeFeedIterator<any>

Paramètres

partitionKey
PartitionKey
changeFeedOptions
ChangeFeedOptions

Retours

ChangeFeedIterator<any>

changeFeed<T>(ChangeFeedOptions)

Créer un ChangeFeedIterator pour itérer sur les pages de modifications

function changeFeed<T>(changeFeedOptions?: ChangeFeedOptions): ChangeFeedIterator<T>

Paramètres

changeFeedOptions
ChangeFeedOptions

Retours

ChangeFeedIterator<T>

changeFeed<T>(PartitionKey, ChangeFeedOptions)

Créer un ChangeFeedIterator pour itérer sur les pages de modifications

function changeFeed<T>(partitionKey: PartitionKey, changeFeedOptions?: ChangeFeedOptions): ChangeFeedIterator<T>

Paramètres

partitionKey
PartitionKey
changeFeedOptions
ChangeFeedOptions

Retours

ChangeFeedIterator<T>

create<T>(T, RequestOptions)

Créez un élément.

Tout type fourni, T, n’est pas nécessairement appliqué par le Kit de développement logiciel (SDK). Vous pouvez obtenir plus ou moins de propriétés et il est à votre logique de l’appliquer.

Il n’existe aucun schéma défini pour les éléments JSON. Ils peuvent contenir n’importe quel nombre de propriétés personnalisées.

function create<T>(body: T, options?: RequestOptions): Promise<ItemResponse<T>>

Paramètres

body

T

Représente le corps de l’élément. Peut contenir n’importe quel nombre de propriétés définies par l’utilisateur.

options
RequestOptions

Utilisé pour modifier la requête (par exemple, en spécifiant la clé de partition).

Retours

Promise<ItemResponse<T>>

getChangeFeedIterator<T>(ChangeFeedIteratorOptions)

Retourne un itérateur pour itérer sur les pages de modifications. L’itérateur retourné peut être utilisé pour extraire les modifications d’une clé de partition unique, d’une plage de flux ou d’un conteneur entier.

function getChangeFeedIterator<T>(changeFeedIteratorOptions?: ChangeFeedIteratorOptions): ChangeFeedPullModelIterator<T>

Paramètres

changeFeedIteratorOptions
ChangeFeedIteratorOptions

Retours

ChangeFeedPullModelIterator<T>

query(string | SqlQuerySpec, FeedOptions)

Interroge tous les éléments.

exemple de

Lire tous les éléments dans le tableau.

const querySpec: SqlQuerySpec = {
  query: "SELECT * FROM Families f WHERE f.lastName = @lastName",
  parameters: [
    {name: "@lastName", value: "Hendricks"}
  ]
};
const {result: items} = await items.query(querySpec).fetchAll();

function query(query: string | SqlQuerySpec, options?: FeedOptions): QueryIterator<any>

Paramètres

query

string | SqlQuerySpec

Configuration de requête pour l’opération. Pour plus d’informations sur la configuration d’une requête, consultez SqlQuerySpec.

options
FeedOptions

Utilisé pour modifier la requête (par exemple, en spécifiant la clé de partition).

Retours

QueryIterator<any>

query<T>(string | SqlQuerySpec, FeedOptions)

Interroge tous les éléments.

exemple de

Lire tous les éléments dans le tableau.

const querySpec: SqlQuerySpec = {
  query: "SELECT firstname FROM Families f WHERE f.lastName = @lastName",
  parameters: [
    {name: "@lastName", value: "Hendricks"}
  ]
};
const {result: items} = await items.query<{firstName: string}>(querySpec).fetchAll();

function query<T>(query: string | SqlQuerySpec, options?: FeedOptions): QueryIterator<T>

Paramètres

query

string | SqlQuerySpec

Configuration de requête pour l’opération. Pour plus d’informations sur la configuration d’une requête, consultez SqlQuerySpec.

options
FeedOptions

Utilisé pour modifier la requête (par exemple, en spécifiant la clé de partition).

Retours

QueryIterator<T>

readAll(FeedOptions)

Lisez tous les éléments.

Il n’existe aucun schéma défini pour les éléments JSON. Ils peuvent contenir n’importe quel nombre de propriétés personnalisées.

exemple de

Lire tous les éléments dans le tableau.

const {body: containerList} = await items.readAll().fetchAll();

function readAll(options?: FeedOptions): QueryIterator<ItemDefinition>

Paramètres

options
FeedOptions

Utilisé pour modifier la requête (par exemple, en spécifiant la clé de partition).

Retours

QueryIterator<ItemDefinition>

readAll<T>(FeedOptions)

Lisez tous les éléments.

Tout type fourni, T, n’est pas nécessairement appliqué par le Kit de développement logiciel (SDK). Vous pouvez obtenir plus ou moins de propriétés et il est à votre logique de l’appliquer.

Il n’existe aucun schéma défini pour les éléments JSON. Ils peuvent contenir n’importe quel nombre de propriétés personnalisées.

exemple de

Lire tous les éléments dans le tableau.

const {body: containerList} = await items.readAll().fetchAll();

function readAll<T>(options?: FeedOptions): QueryIterator<T>

Paramètres

options
FeedOptions

Utilisé pour modifier la requête (par exemple, en spécifiant la clé de partition).

Retours

QueryIterator<T>

readChangeFeed(ChangeFeedOptions)

Avertissement

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

Use changeFeed instead.

Créer un ChangeFeedIterator pour itérer sur les pages de modifications

function readChangeFeed(changeFeedOptions?: ChangeFeedOptions): ChangeFeedIterator<any>

Paramètres

changeFeedOptions
ChangeFeedOptions

Retours

ChangeFeedIterator<any>

readChangeFeed(PartitionKey, ChangeFeedOptions)

Avertissement

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

Use changeFeed instead.

Créer un ChangeFeedIterator pour itérer sur les pages de modifications

exemple de

Lisez à partir du début du flux de modification.

const iterator = items.readChangeFeed({ startFromBeginning: true });
const firstPage = await iterator.fetchNext();
const firstPageResults = firstPage.result
const secondPage = await iterator.fetchNext();

function readChangeFeed(partitionKey: PartitionKey, changeFeedOptions?: ChangeFeedOptions): ChangeFeedIterator<any>

Paramètres

partitionKey
PartitionKey
changeFeedOptions
ChangeFeedOptions

Retours

ChangeFeedIterator<any>

readChangeFeed<T>(ChangeFeedOptions)

Avertissement

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

Use changeFeed instead.

Créer un ChangeFeedIterator pour itérer sur les pages de modifications

function readChangeFeed<T>(changeFeedOptions?: ChangeFeedOptions): ChangeFeedIterator<T>

Paramètres

changeFeedOptions
ChangeFeedOptions

Retours

ChangeFeedIterator<T>

readChangeFeed<T>(PartitionKey, ChangeFeedOptions)

Avertissement

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

Use changeFeed instead.

Créer un ChangeFeedIterator pour itérer sur les pages de modifications

function readChangeFeed<T>(partitionKey: PartitionKey, changeFeedOptions?: ChangeFeedOptions): ChangeFeedIterator<T>

Paramètres

partitionKey
PartitionKey
changeFeedOptions
ChangeFeedOptions

Retours

ChangeFeedIterator<T>

upsert(unknown, RequestOptions)

Upsert un élément.

Il n’existe aucun schéma défini pour les éléments JSON. Ils peuvent contenir n’importe quel nombre de propriétés personnalisées.

function upsert(body: unknown, options?: RequestOptions): Promise<ItemResponse<ItemDefinition>>

Paramètres

body

unknown

Représente le corps de l’élément. Peut contenir n’importe quel nombre de propriétés définies par l’utilisateur.

options
RequestOptions

Utilisé pour modifier la requête (par exemple, en spécifiant la clé de partition).

Retours

Promise<ItemResponse<ItemDefinition>>

upsert<T>(T, RequestOptions)

Upsert un élément.

Tout type fourni, T, n’est pas nécessairement appliqué par le Kit de développement logiciel (SDK). Vous pouvez obtenir plus ou moins de propriétés et il est à votre logique de l’appliquer.

Il n’existe aucun schéma défini pour les éléments JSON. Ils peuvent contenir n’importe quel nombre de propriétés personnalisées.

function upsert<T>(body: T, options?: RequestOptions): Promise<ItemResponse<T>>

Paramètres

body

T

Représente le corps de l’élément. Peut contenir n’importe quel nombre de propriétés définies par l’utilisateur.

options
RequestOptions

Utilisé pour modifier la requête (par exemple, en spécifiant la clé de partition).

Retours

Promise<ItemResponse<T>>