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 JSON-geformatteerde gegevens met een unieke id.

Item, itemdefinitie en antwoord op item

In de JavaScript SDK hebben de drie objecten die zijn gerelateerd aan een item verschillende doeleinden.

Naam	Operations
Artikel	Functionaliteit zoals lezen, patchen, 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 geslaagd antwoord valt binnen het bereik van 200-299.
• activityId: unieke id voor de bewerking, zoals maken, lezen, vervangen of verwijderen.
• etag: Entiteitstag die is gekoppeld aan de gegevens. Gebruiken 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.

Zodra de URI voor een item is gemaakt, heeft 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 create-methode.

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

Open een item via het itemobject . Dit kan worden geopend vanuit het containerobject of gewijzigd van 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, batchen, wijzigingenfeed bekijken, alles lezen, upsert of query-items.
• Item (enkelvoud): een item lezen, patchen, vervangen of verwijderen.

Een item vervangen

Vervang de gegevens door het itemobject door de vervangmethode .

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

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

Een item verwijderen

Verwijder het item met de verwijdermethode van het itemobject.

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 voor het item.

Een item lezen