Consulta de elementos en Azure Cosmos DB for NoSQL con JavaScript
SE APLICA A: NoSQL
Los elementos de Azure Cosmos DB representan entidades almacenadas dentro de un contenedor. En la API para NoSQL, un elemento consta de datos con formato JSON con un identificador único. Cuando emite consultas mediante la API para NoSQL, los resultados se devuelven como una matriz JSON de documentos JSON.
Consulta de elementos mediante SQL
Azure Cosmos DB for NoSQL admite el uso del Lenguaje de consulta estructurado (SQL) para realizar consultas en elementos de contenedores. Una consulta SQL simple como SELECT * FROM products
devolverá todos los elementos y propiedades de un contenedor. Las consultas pueden ser aún más complejas e incluir proyecciones de campos específicos, filtros y otras cláusulas comunes de SQL:
SELECT
p.name,
p.quantity
FROM
products p
WHERE
p.quantity > 500
Para más información sobre la sintaxis de SQL para Azure Cosmos DB for NoSQL, consulte Introducción a las consultas SQL.
Consulta de un elemento
Cree una matriz de elementos coincidentes a partir del objeto items del contenedor mediante el 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 `);
}
Cada método de consulta devuelve un objeto QueryIterator. Use el método fetchAll del iterador para recuperar todos los resultados. QueryIterator también proporciona fetchNext, hasMoreResults y otros métodos para ayudarle a usar los resultados.
Pasos siguientes
Ahora que ha consultado varios elementos, pruebe uno de nuestros tutoriales integrales con la API de NoSQL.