Creare un elemento in Azure Cosmos DB per NoSQL usando JavaScript

Gli elementi in Azure Cosmos DB rappresentano un'entità specifica archiviata all'interno di un contenitore. Nell'API per NoSQL, un elemento è costituito da dati formattati per JSON con un identificatore univoco.

Elemento, definizione dell'elemento e risposta dell'elemento

In JavaScript SDK i tre oggetti correlati a un elemento hanno scopi diversi.

Nome	Operations
elemento	Funzionalità che includono Lettura, Patch, Sostituisci, Elimina.
ItemDefinition	Oggetto dati personalizzato. Include automaticamente le proprietà id e ttl.
ItemResponse	Include statusCode, iteme altre proprietà.

Utilizzare le proprietà dell'oggetto ItemResponse per comprendere il risultato dell'operazione.

• statusCode: codice di stato HTTP. Una risposta con esito positivo è nell'intervallo 200-299.
• activityId: identificatore univoco per l'operazione, ad esempio create, read, replace o delete.
• etag: tag di entità associato ai dati. Usare per la concorrenza ottimistica, la memorizzazione nella cache e le richieste condizionali.
• item: oggetto item usato per eseguire operazioni quali lettura, sostituzione, eliminazione.
• resource: dati personalizzati.

Creare un identificatore univoco per un elemento

L'identificatore univoco è una stringa distinta che identifica un elemento all'interno di un contenitore. La id proprietà è l'unica proprietà obbligatoria quando si crea un nuovo documento JSON. Ad esempio, questo documento JSON è un elemento valido in Azure Cosmos DB:

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

Nell'ambito di un contenitore, due elementi non possono condividere lo stesso identificatore univoco.

Importante

La proprietà id fa distinzione tra maiuscole e minuscole. Le proprietà denominate ID, IdiD, e _id verranno considerate come proprietà JSON arbitrarie.

Dopo la creazione, l'URI per un elemento è in questo formato:

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

Quando si fa riferimento all'elemento usando un URI, usare l'identificatore di risorsa generato dal sistema anziché il id campo. Per altre informazioni sulle proprietà degli elementi generati dal sistema in Azure Cosmos DB per NoSQL, vedere proprietà di un elemento

Creare un elemento

Creare un elemento con l'oggetto items del contenitore usando il metodo create .

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

Accedere a un elemento

Accedere a un elemento tramite l'oggetto Item . È possibile accedere dall'oggetto Container o modificarlo dagli oggetti Database o 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();

Accesso per oggetto:

• Elementi (plurale): crea, batch, osserva il feed delle modifiche, leggi tutti, upsert o interroga gli elementi.
• Elemento (singolare): lettura, patch, sostituzione o eliminazione di un elemento.

Sostituire un elemento

Sostituire i dati con l'oggetto Item con il metodo 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 
    });

Leggere un elemento

Leggere i dati più aggiornati con il metodo read dell'oggetto Item.

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

Eliminare un elemento

Eliminare l'elemento con il metodo delete dell'oggetto Item.

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

Passaggi successivi

Dopo aver creato vari elementi, usare la guida successiva per eseguire una query per l'elemento.

Leggere un elemento