Vytvoření položky ve službě Azure Cosmos DB for NoSQL pomocí JavaScriptu

PLATÍ PRO: NoSQL

Položky ve službě Azure Cosmos DB představují konkrétní entitu uloženou v kontejneru. V rozhraní API pro NoSQL se položka skládá z dat ve formátu JSON s jedinečným identifikátorem.

Položka, definice položky a odpověď položky

V sadě JavaScript SDK mají tři objekty související s položkou různé účely.

Název	Operace
Položka	Funkce, včetně čtení, opravy, nahrazení, odstranění
ItemDefinition	Váš vlastní datový objekt. Zahrnuje vlastnosti id a ttl automaticky.
ItemResponse	Zahrnuje statusCode, itema další vlastnosti.

K pochopení výsledku operace použijte vlastnosti ItemResponse objektu.

• statusCode: Stavový kód HTTP. Úspěšná odpověď je v rozsahu 200–299.
• activityId: Jedinečný identifikátor operace, jako je vytvoření, čtení, nahrazení nebo odstranění.
• značka etag: Značka entity přidružená k datům. Slouží k optimistické souběžnosti, ukládání do mezipaměti a podmíněným požadavkům.
• item: Objekt položky používaný k provádění operací, jako je čtení, nahrazení, odstranění.
• prostředek: Vaše vlastní data.

Vytvoření jedinečného identifikátoru pro položku

Jedinečný identifikátor je jedinečný řetězec, který identifikuje položku v kontejneru. Tato id vlastnost je jedinou povinnou vlastností při vytváření nového dokumentu JSON. Tento dokument JSON je například platná položka ve službě Azure Cosmos DB:

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

V rámci oboru kontejneru nemůžou dvě položky sdílet stejný jedinečný identifikátor.

Důležité

Vlastnost id je rozlišována podle velkých a malých písmen. Vlastnosti s názvem ID, IdiDa _id budou považovány za libovolnou vlastnost JSON.

Po vytvoření je identifikátor URI položky v tomto formátu:

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

Při odkazování na položku pomocí identifikátoru URI použijte místo pole identifikátoridsystémem. Další informace o systémově generovaných vlastnostech položek ve službě Azure Cosmos DB for NoSQL najdete v tématu Vlastnosti položky.

Vytvoření položky

Pomocí metody create vytvořte položku s objektem položek kontejneru.

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

Přístup k položce

Přístup k položce prostřednictvím objektu Item . Toto lze zpřístupnit z objektu Container nebo změnit z objektů Database či CosmosClient.

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

Přístup podle objektu:

• Položky (množné číslo): Vytvářejte, dávkujte, sledujte kanál změn, čtěte všechny, vkládejte nebo aktualizujte, nebo se dotazujte na položky.
• Položka (jednotné číslo): Číst, opravit, nahradit nebo odstranit položku.

Nahrazení položky

Nahraďte data objektem Item metodou 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 
    });

Přečíst položku

Přečtěte si nejaktuálnější data pomocí metody čtení objektu Item.

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

Odstranění položky

Odstraňte položku metodou delete objektu Item.

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

Další kroky

Teď, když jste vytvořili různé položky, použijte další příručku k dotazování na položku.

Přečíst položku