Tworzenie elementu w usłudze Azure Cosmos DB for NoSQL przy użyciu języka JavaScript

DOTYCZY: NoSQL

Elementy w usłudze Azure Cosmos DB reprezentują określoną jednostkę przechowywaną w kontenerze. W interfejsie API for NoSQL element składa się z danych w formacie JSON z unikatowym identyfikatorem.

Element, definicja elementu i odpowiedź na element

W zestawie SDK języka JavaScript trzy obiekty powiązane z elementem mają różne cele.

Nazwisko	Operacje
Produkt	Funkcjonalność obejmująca czytanie, aktualizację, zamianę, usunięcie.
ElementDefinition	Twój niestandardowy obiekt danych. Zawiera automatycznie właściwości id i ttl.
ItemResponse	Obejmuje statusCode, item, oraz inne właściwości.

Użyj właściwości obiektu ItemResponse , aby zrozumieć wynik operacji.

• statusCode: kod stanu HTTP. Pomyślna odpowiedź znajduje się w zakresie od 200 do 299.
• activityId: unikatowy identyfikator operacji, taki jak tworzenie, odczyt, zastępowanie lub usuwanie.
• etag: tag jednostki skojarzony z danymi. Służy do optymistycznej współbieżności, buforowania i żądań warunkowych.
• item: Obiekt elementu używany do wykonywania operacji, takich jak odczyt, zastępowanie, usuwanie.
• resource: Twoje dedykowane dane.

Tworzenie unikatowego identyfikatora elementu

Unikatowy identyfikator jest odrębnym ciągiem, który identyfikuje element w kontenerze. Właściwość id jest jedyną wymaganą właściwością podczas tworzenia nowego dokumentu JSON. Na przykład ten dokument JSON jest prawidłowym elementem w usłudze Azure Cosmos DB:

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

W zakresie kontenera dwa elementy nie mogą współdzielić tego samego unikatowego identyfikatora.

Ważne

Właściwość id uwzględnia wielkość liter. Właściwości o nazwie ID, Id, iDi _id będą traktowane jako dowolna właściwość JSON.

Po utworzeniu identyfikator URI elementu ma następujący format:

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

Podczas odwoływania się do elementu za pomocą identyfikatora URI użyj identyfikatora zasobu wygenerowanego przez system zamiast pola . Aby uzyskać więcej informacji na temat właściwości elementu generowanego przez system w usłudze Azure Cosmos DB for NoSQL, zobacz właściwości elementu

Tworzenie elementu

Utwórz element z obiektu items kontenera przy użyciu metody create.

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

Uzyskiwanie dostępu do elementu

Uzyskiwanie dostępu do elementu za pośrednictwem obiektu Item . Można uzyskać do tego dostęp z obiektu Kontener lub zmienić go z obiektów Database lub 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();

Dostęp według obiektu:

• Elementy (mnoga): utwórz, przetwarzaj partiami, obejrzyj zestawienie zmian, odczytaj wszystkie, dodaj lub zaktualizuj, lub przeglądaj elementy.
• Element (pojedyncza): odczyt, poprawka, zastąpienie lub usunięcie elementu.

Zastępowanie elementu

Zastąp dane obiektem Item metodą 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 
    });

Odczytaj element

Przeczytaj najnowsze dane za pomocą metody read obiektu Item.

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

Usuwanie elementu

Usuń element za pomocą metodydelete obiektu Item.

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

Następne kroki

Po utworzeniu różnych elementów użyj następnego przewodnika, aby wykonać zapytanie o element.

Odczytaj element