Share via


Consultar itens no Azure Cosmos DB for NoSQL usando o JavaScript

APLICA-SE A: NoSQL

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

Consultar itens usando SQL

O Azure Cosmos DB for NoSQL dá suporte ao uso da linguagem SQL 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 comuns de SQL:

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

Para saber mais sobre a sintaxe SQL da Azure Cosmos DB for NoSQL, confira Introdução a consultas SQL.

Consultar um item

Crie uma matriz de itens correspondentes do objeto itens do contêiner usando o método de consulta.

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 ajudar você a usar os resultados.

Próximas etapas

Agora que você consultou vários itens, experimente um dos tutoriais de ponta a ponta com a API do NoSQL.