Skapa ett objekt i Azure Cosmos DB för NoSQL med JavaScript

GÄLLER FÖR: NoSQL

Objekt i Azure Cosmos DB representerar en specifik entitet som lagras i en container. I API:et för NoSQL består ett objekt av JSON-formaterade data med en unik identifierare.

Svar på objekt, objektdefinition och objekt

I JavaScript SDK har de tre objekt som är relaterade till ett objekt olika syften.

Name	Operations
Artikel	Funktioner som Läs, Korrigera, Ersätt, Ta bort.
ItemDefinition	Ditt anpassade dataobjekt. Innehåller id och ttl egenskaper automatiskt.
ItemResponse	Innehåller statusCode, itemoch andra egenskaper.

Använd egenskaperna för Objektet ItemResponse för att förstå resultatet av åtgärden.

• statusCode: HTTP-statuskod. Ett lyckat svar är inom intervallet 200–299.
• activityId: Unik identifierare för åtgärden, till exempel skapa, läsa, ersätta eller ta bort.
• etag: Entitetstagg som är associerad med data. Använd för optimistisk samtidighet, cachelagring och villkorsstyrda begäranden.
• item: Objektobjekt som används för att utföra åtgärder som att läsa, ersätta, ta bort.
• resurs: Dina anpassade data.

Skapa en unik identifierare för ett objekt

Den unika identifieraren är en distinkt sträng som identifierar ett objekt i en container. Egenskapen id är den enda egenskap som krävs när du skapar ett nytt JSON-dokument. Det här JSON-dokumentet är till exempel ett giltigt objekt i Azure Cosmos DB:

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

Inom omfånget för en container kan två objekt inte dela samma unika identifierare.

Viktigt!

Egenskapen id är skiftlägeskänslig. Egenskaper med namnet ID, Id, iDoch _id behandlas som en godtycklig JSON-egenskap.

När det har skapats är URI:n för ett objekt i det här formatet:

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

När du refererar till objektet med hjälp av en URI använder du den systemgenererade resursidentifieraren i stället för fältetid. Mer information om systemgenererade objektegenskaper i Azure Cosmos DB för NoSQL finns i egenskaper för ett objekt

Skapa ett objekt

Skapa ett objekt med containerns objektobjekt med hjälp av create-metoden .

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

Få åtkomst till ett objekt

Få åtkomst till ett objekt via objektobjektet. Detta kan nås från containerobjektet eller ändras från antingen databas- eller CosmosClient-objekten.

// 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();

Åtkomst efter objekt:

• Objekt (plural): Skapa, batcha, titta på ändringsflöde, läsa alla, upsert eller frågeobjekt.
• Objekt (singular): Läsa, korrigera, ersätta eller ta bort ett objekt.

Ersätta ett objekt

Ersätt data med objektobjektet med ersätt-metoden.

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

Läsa ett objekt

Läs de senaste data med objektobjektets läsmetod .

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

Ta bort ett objekt

Ta bort objektet med objektobjektets borttagningsmetod .

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

Nästa steg

Nu när du har skapat olika objekt använder du nästa guide för att fråga efter objekt.

Läsa ett objekt