Elem létrehozása az Azure Cosmos DB for NoSQL-ben JavaScript használatával

A KÖVETKEZŐRE VONATKOZIK: NoSQL

Az Azure Cosmos DB elemei egy tárolóban tárolt adott entitást jelölnek. A NoSQL API-ban egy elem JSON-formátumú adatokat tartalmaz egyedi azonosítóval.

Elem, elemdefiníció és elemválasz

A JavaScript SDK-ban az elemhez kapcsolódó három objektumnak különböző céljai vannak.

Név	Üzemeltetés
Tétel	Olyan funkciók, mint az Olvasás, Javítás, Csere, Törlés.
ItemDefinition	Az egyéni adatobjektum. Automatikusan tartalmazza a id és ttl tulajdonságokat.
ItemResponse	Tartalmazza statusCode, item, és egyéb tulajdonságokat.

A művelet eredményének megértéséhez használja az ItemResponse objektum tulajdonságait.

• statusCode: HTTP állapotkód. A sikeres válasz a 200–299 közötti tartományban van.
• activityId: A művelet egyedi azonosítója, például létrehozás, olvasás, csere vagy törlés.
• etag: Az adatokhoz társított entitáscímke. Optimista egyidejűséghez, gyorsítótárazáshoz és feltételes kérelmekhez használható.
• elem: Az olyan műveletek végrehajtásához használt elemobjektum , mint az olvasás, a csere, a törlés.
• erőforrás: Az egyéni adatok.

Egyedi azonosító létrehozása egy elemhez

Az egyedi azonosító egy különálló sztring, amely egy tárolón belüli elemet azonosít. Új id JSON-dokumentum létrehozásakor a tulajdonság az egyetlen kötelező tulajdonság. Ez a JSON-dokumentum például egy érvényes elem az Azure Cosmos DB-ben:

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

A tároló hatókörén belül két elem nem oszthatja meg ugyanazt az egyedi azonosítót.

Fontos

A id tulajdonság érzékeny a kis- és nagybetűkre. A névvel ellátott IDtulajdonságokIdiD, és _id tetszőleges JSON-tulajdonságként lesznek kezelve.

A létrehozás után az elem URI-ja a következő formátumban van:

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

Amikor URI használatával hivatkozik az elemre, használja a rendszer által létrehozott erőforrás-azonosítót a id mező helyett. Az Azure Cosmos DB for NoSQL rendszer által létrehozott elemtulajdonságairól további információt az elem tulajdonságai című témakörben talál .

Elem létrehozása

Hozzon létre egy elemet a tároló items objektumával a create metódussal.

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

Elem elérése

Elem elérése az Elem objektumon keresztül. Ez a tárolóobjektumból érhető el, vagy az Adatbázis vagy a CosmosClient objektumból módosítható.

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

Hozzáférés objektum szerint:

• Elemek (többes szám): Létrehozás, kötegelt feldolgozás, változáscsatorna megtekintése, az összes elem olvasása, elemek upsertelése vagy lekérdezése.
• Elem (egyedi): Elem olvasása, javítása, cseréje vagy törlése.

Elem cseréje

Helyettesítse az adatokat az Elem objektum használatával a csere metódus segítségével.

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

Elem megtekintése

Olvassa el a legfrissebb adatokat az Elem objektum olvasási módszerével.

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

Elem törlése

Törölje az elemet az Elem objektum törlési metódusával.

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

Következő lépések

Most, hogy létrehozott különböző elemeket, a következő útmutató segítségével kérdezheti le az elemeket.

Egy elem elolvasása