Bagikan melalui


Mengkueri item di Azure Cosmos DB untuk NoSQL menggunakan JavaScript

BERLAKU UNTUK: NoSQL

Item di Azure Cosmos DB mewakili entitas yang disimpan dalam kontainer. Dalam API untuk NoSQL, item terdiri dari data berformat JSON dengan pengidentifikasi unik. Saat Anda melakukan kueri menggunakan API untuk NoSQL, hasil dikembalikan sebagai dokumen JSON dalam bentuk array JSON.

Mengkueri item menggunakan SQL

Azure Cosmos DB for NoSQL mendukung penggunaan Bahasa Permintaan Terstruktur (SQL) untuk melakukan kueri pada item dalam kontainer. Kueri SQL sederhana seperti SELECT * FROM products mengembalikan semua item dan properti dari kontainer. Kueri bisa lebih kompleks dan menyertakan proyeksi bidang tertentu, filter, dan klausa SQL umum lainnya:

SELECT 
    p.name, 
    p.quantity
FROM 
    products p 
WHERE 
    p.quantity > 500

Untuk mempelajari selengkapnya tentang sintaks SQL untuk Azure Cosmos DB untuk NoSQL, lihat Mulai menggunakan kueri SQL.

Membuat kueri item

Buat array dari item yang sesuai dari objek item kontainer menggunakan metode kueri.

const querySpec = {
    query: `SELECT * FROM ${container.id} f WHERE  f.name = @name`,
    parameters: [{
        name: "@name",
        value: "Sunnox Surfboard",
    }],
};
const { resources } = await container.items.query(querySpec).fetchAll();

for (const product of resources) {
  console.log(`${product.name}, ${product.quantity} in stock `);
}

Metode kueri mengembalikan objek QueryIterator . Gunakan metode fetchAll iterator untuk mengambil semua hasilnya. QueryIterator juga menyediakan fetchNext, hasMoreResults, dan metode lainnya untuk membantu Anda menggunakan hasilnya.

Langkah berikutnya

Sekarang setelah Anda meminta beberapa item, cobalah salah satu tutorial menyeluruh kami dengan API yang mendukung NoSQL.