Delen via


Query's uitvoeren op items in Azure Cosmos DB for NoSQL met behulp van JavaScript

VAN TOEPASSING OP: NoSQL

Items in Azure Cosmos DB vertegenwoordigen entiteiten die zijn opgeslagen in een container. In de API voor NoSQL bestaat een item uit JSON-geformatteerde gegevens met een unieke id. Wanneer u query's uitvraagt met behulp van de API voor NoSQL, worden resultaten geretourneerd als een JSON-matrix met JSON-documenten.

Query's uitvoeren op items met SQL

Azure Cosmos DB for NoSQL ondersteunt het gebruik van Structured Query Language (SQL) om query's uit te voeren op items in containers. Een eenvoudige SQL-query retourneert alle SELECT * FROM products items en eigenschappen uit een container. Query's kunnen nog complexer zijn en specifieke veldprojecties, filters en andere algemene SQL-componenten bevatten:

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

Zie Aan de slag met SQL-query's voor meer informatie over de SQL-syntaxis voor Azure Cosmos DB for NoSQL.

Een query uitvoeren op een item

Maak een matrix met overeenkomende items van het itemobject van de container met behulp van de querymethode.

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 `);
}

De querymethode retourneert een QueryIterator-object . Gebruik de methode fetchAll van de iterator om alle resultaten op te halen. QueryIterator biedt ook fetchNext, hasMoreResults en andere methoden om u te helpen de resultaten te gebruiken.

Volgende stappen

Nu u meerdere items hebt opgevraagd, kunt u een van onze end-to-end zelfstudies uitproberen met de API voor NoSQL.