Erstellen eines Elements in Azure Cosmos DB für NoSQL mit JavaScript

Elemente in Azure Cosmos DB stellen eine bestimmte Entität dar, die in einem Container gespeichert ist. In der API für NoSQL besteht ein Element aus Daten im JSON-Format mit einem eindeutigen Bezeichner.

Element, Elementdefinition und Elementantworten

Im JavaScript SDK haben die drei Objekte, die mit einem Element zusammenhängen, unterschiedliche Zwecke.

Verwenden Sie die Eigenschaften des ItemResponse-Objekts , um das Ergebnis des Vorgangs zu verstehen.

• statusCode: HTTP-Statuscode. Eine erfolgreiche Antwort befindet sich im Bereich von 200-299.
• activityId: Eindeutiger Bezeichner für den Vorgang, z. B. Erstellen, Lesen, Ersetzen oder Löschen.
• etag: Entitätstag, das den Daten zugeordnet ist. Wird für optimistische Parallelität, Zwischenspeicherung und bedingte Anforderungen verwendet.
• item: Item-Objekt zum Ausführen von Vorgängen wie Lesen, Ersetzen, Löschen.
• ressource: Ihre benutzerdefinierten Daten.

Erstellen eines eindeutigen Bezeichners für ein Element

Der eindeutige Bezeichner ist eine unterschiedliche Zeichenfolge, die ein Element in einem Container identifiziert. Die id Eigenschaft ist die einzige erforderliche Eigenschaft beim Erstellen eines neuen JSON-Dokuments. Dieses JSON-Dokument ist beispielsweise ein gültiges Element in Azure Cosmos DB:

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

Innerhalb des Bereichs eines Containers können zwei Elemente nicht denselben eindeutigen Bezeichner verwenden.

Nach der Erstellung befindet sich der URI für ein Element in diesem Format:

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

Verwenden Sie beim Verweisen auf das Element mithilfe eines URI den vom System generierten Ressourcenbezeichner anstelle des id Felds. Weitere Informationen zu systemgenerierten Elementeigenschaften in Azure Cosmos DB für NoSQL finden Sie unter Eigenschaften eines Elements.

Erstellen eines Elements

Erstellen Sie ein Element mit dem Elementobjekt des Containers mithilfe der 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 
    });

Zugreifen auf ein Element

Greifen Sie über das Item-Objekt auf ein Element zu. Auf diese kann über das Container-Objekt zugegriffen oder von den Database - oder CosmosClient-Objekten geändert werden.

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

Zugriff nach Objekt:

• Elemente (Plural): Elemente erstellen, stapeln, Änderungsüberwachung, alle lesen, einfügen oder abfragen.
• Element (Singular): Lesen, Patchen, Ersetzen oder Löschen eines Elements.

Ersetzen eines Elements

Ersetzen Sie die Daten im Item-Objekt mit der replace-Methode.

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

Lesen eines Elements

Lesen Sie die aktuellsten Daten mit der Read-Methode des Item-Objekts.

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

Löschen eines Elements

Löschen Sie das Element mit der Löschmethode des Item-Objekts.

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

Nächste Schritte

Nachdem Sie nun verschiedene Elemente erstellt haben, verwenden Sie das nächste Handbuch zum Abfragen des Elements.