Een item maken in Azure Cosmos DB for NoSQL met behulp van JavaScript

VAN TOEPASSING OP: NoSQL

Items in Azure Cosmos DB vertegenwoordigen een specifieke entiteit die is opgeslagen in een container. In de API voor NoSQL bestaat een item uit gegevens in JSON-indeling met een unieke id.

Item, itemdefinitie en itemantwoord

In de JavaScript SDK hebben de drie objecten die betrekking hebben op een item verschillende doeleinden.

Naam	Operations
Item	Functionaliteit, waaronder Lezen, Patch, Vervangen, Verwijderen.
ItemDefinition	Uw aangepaste gegevensobject. Bevat id en ttl eigenschappen automatisch.
ItemResponse	Bevat statusCode, itemen andere eigenschappen.

Gebruik de eigenschappen van het object ItemResponse om het resultaat van de bewerking te begrijpen.

• statusCode: HTTP-statuscode. Een geslaagde reactie bevindt zich in het bereik 200-299.
• activityId: unieke id voor de bewerking, zoals maken, lezen, vervangen of verwijderen.
• etag: entiteitstag die is gekoppeld aan de gegevens. Gebruik voor optimistische gelijktijdigheid, caching en voorwaardelijke aanvragen.
• item: itemobject dat wordt gebruikt voor het uitvoeren van bewerkingen zoals lezen, vervangen, verwijderen.
• resource: uw aangepaste gegevens.

Een unieke id voor een item maken

De unieke id is een afzonderlijke tekenreeks die een item in een container identificeert. De id eigenschap is de enige vereiste eigenschap bij het maken van een nieuw JSON-document. Dit JSON-document is bijvoorbeeld een geldig item in Azure Cosmos DB:

{
  "id": "unique-string-2309509"
}

Binnen het bereik van een container kunnen twee items niet dezelfde unieke id delen.

Belangrijk

De id eigenschap is hoofdlettergevoelig. Eigenschappen met de naam ID, Id, iDen _id worden behandeld als een willekeurige JSON-eigenschap.

Na het maken heeft de URI voor een item deze indeling:

https://<cosmos-account-name>.documents.azure.com/dbs/<database-name>/docs/<item-resource-identifier>

Wanneer u naar het item verwijst met behulp van een URI, gebruikt u de door het systeem gegenereerde resource-id in plaats van het id veld. Zie Eigenschappen van een item voor meer informatie over door het systeem gegenereerde itemeigenschappen in Azure Cosmos DB for NoSQL

Een item maken

Maak een item met het itemobject van de container met behulp van de methode create .

const { statusCode, item, resource, activityId, etag} = await container.items.create({ 
        id: '2', 
        category: 'gear-surf-surfboards',
        name: 'Sunnox Surfboard',
        quantity: 8,
        sale: true 
    });

Een item openen

Toegang tot een item via het object Item . Dit kan worden geopend vanuit het Container-object of gewijzigd vanuit de database - of CosmosClient-objecten .

// Chained, then use a method of the Item object such as `read`
const { statusCode, item, resource, activityId, etag} = await client.database(databaseId).container(containerId).item(itemId).read();

Toegang per object:

• Items (meervoud): maken, batch, watch wijzigingenfeed, alles lezen, upsert of queryitems uitvoeren.
• Item (enkelvoud): een item lezen, patchen, vervangen of verwijderen.

Een item vervangen

Vervang de gegevens door het object Item door de methode replace .

const { statusCode, item, resource, activityId, etag} = await item.replace({ 
        id: '2', 
        category: 'gear-surf-surfboards-retro',
        name: 'Sunnox Surfboard Retro',
        quantity: 5,
        sale: false 
    });

Een item lezen

Lees de meest recente gegevens met de leesmethode van het object Item.

const { statusCode, item, resource, activityId, etag} = await item.read();

Een item verwijderen

Verwijder het item met de verwijdermethode van het object Item.

const { statusCode, item, activityId, etag} = await item.delete();

Volgende stappen

Nu u verschillende items hebt gemaakt, gebruikt u de volgende handleiding om een query uit te voeren op een item.

Een item lezen