Itens de consulta no Azure Cosmos DB para NoSQL usando JavaScript

APLICA-SE A: NoSQL

Os itens no Azure Cosmos DB representam entidades armazenadas em um contêiner. Na API para NoSQL, um item consiste em dados formatados em JSON com um identificador exclusivo. Quando você emite consultas usando a API para NoSQL, os resultados são retornados como uma matriz JSON de documentos JSON.

Itens de consulta usando SQL

O Azure Cosmos DB para NoSQL dá suporte ao uso de SQL (Structured Query Language) para executar consultas em itens em contêineres. Uma consulta SQL simples como SELECT * FROM products retorna todos os itens e propriedades de um contêiner. As consultas podem ser ainda mais complexas e incluir projeções de campo específicas, filtros e outras cláusulas SQL comuns:

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

Para saber mais sobre a sintaxe SQL do Azure Cosmos DB para NoSQL, consulte Introdução às consultas SQL.

Consultar um item

Crie uma matriz de itens correspondentes a partir do objeto items do contêiner usando o método query.

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

O método de consulta retorna um objeto QueryIterator . Use o método fetchAll do iterador para recuperar todos os resultados. O QueryIterator também fornece fetchNext, hasMoreResults e outros métodos para ajudá-lo a usar os resultados.

Próximos passos

Agora que você consultou vários itens, experimente um de nossos tutoriais completos com a API para NoSQL.