Consulta de los datos con la API de Azure Cosmos DB para MongoDB
SE APLICA A: 
Azure Cosmos DB API para MongoDB
La API de Azure Cosmos DB para MongoDB admite las consultas de MongoDB.
En este artículo se tratan las tareas siguientes:
- Consulta de los datos almacenados en la base de datos de Cosmos mediante el shell de MongoDB
Puede empezar a trabajar con los ejemplos de este documento y ver el vídeo Consulta de Azure Cosmos DB con el shell de MongoDB.
Documento de ejemplo
En las consultas de este artículo se usa el documento de ejemplo siguiente.
{
"id": "WakefieldFamily",
"parents": [
{ "familyName": "Wakefield", "givenName": "Robin" },
{ "familyName": "Miller", "givenName": "Ben" }
],
"children": [
{
"familyName": "Merriam",
"givenName": "Jesse",
"gender": "female", "grade": 1,
"pets": [
{ "givenName": "Goofy" },
{ "givenName": "Shadow" }
]
},
{
"familyName": "Miller",
"givenName": "Lisa",
"gender": "female",
"grade": 8 }
],
"address": { "state": "NY", "county": "Manhattan", "city": "NY" },
"creationDate": 1431620462,
"isRegistered": false
}
Consulta 1 de ejemplo
Dado el documento de familia de ejemplo anterior, la consulta siguiente devuelve los documentos donde el campo Id. coincide con WakefieldFamily.
Consultar
db.families.find({ id: "WakefieldFamily"})
Resultados
{
"_id": "ObjectId(\"58f65e1198f3a12c7090e68c\")",
"id": "WakefieldFamily",
"parents": [
{
"familyName": "Wakefield",
"givenName": "Robin"
},
{
"familyName": "Miller",
"givenName": "Ben"
}
],
"children": [
{
"familyName": "Merriam",
"givenName": "Jesse",
"gender": "female",
"grade": 1,
"pets": [
{ "givenName": "Goofy" },
{ "givenName": "Shadow" }
]
},
{
"familyName": "Miller",
"givenName": "Lisa",
"gender": "female",
"grade": 8
}
],
"address": {
"state": "NY",
"county": "Manhattan",
"city": "NY"
},
"creationDate": 1431620462,
"isRegistered": false
}
Consulta 2 de ejemplo
La consulta siguiente devuelve todos los elementos secundarios de la familia.
Consultar
db.families.find( { id: "WakefieldFamily" }, { children: true } )
Resultados
{
"_id": "ObjectId("58f65e1198f3a12c7090e68c")",
"children": [
{
"familyName": "Merriam",
"givenName": "Jesse",
"gender": "female",
"grade": 1,
"pets": [
{ "givenName": "Goofy" },
{ "givenName": "Shadow" }
]
},
{
"familyName": "Miller",
"givenName": "Lisa",
"gender": "female",
"grade": 8
}
]
}
Consulta 3 de ejemplo
La consulta siguiente devuelve todas las familias que están registradas.
Consultar
db.families.find( { "isRegistered" : true })
Resultados
No se devolverá ningún documento.
Consulta 4 de ejemplo
La consulta siguiente devuelve todas las familias que no están registradas.
Consultar
db.families.find( { "isRegistered" : false })
Resultados
{
"_id": ObjectId("58f65e1198f3a12c7090e68c"),
"id": "WakefieldFamily",
"parents": [{
"familyName": "Wakefield",
"givenName": "Robin"
}, {
"familyName": "Miller",
"givenName": "Ben"
}],
"children": [{
"familyName": "Merriam",
"givenName": "Jesse",
"gender": "female",
"grade": 1,
"pets": [{
"givenName": "Goofy"
}, {
"givenName": "Shadow"
}]
}, {
"familyName": "Miller",
"givenName": "Lisa",
"gender": "female",
"grade": 8
}],
"address": {
"state": "NY",
"county": "Manhattan",
"city": "NY"
},
"creationDate": 1431620462,
"isRegistered": false
}
Consulta 5 de ejemplo
La consulta siguiente devuelve todas las familias que no están registradas y el estado es NY.
Consultar
db.families.find( { "isRegistered" : false, "address.state" : "NY" })
Resultados
{
"_id": ObjectId("58f65e1198f3a12c7090e68c"),
"id": "WakefieldFamily",
"parents": [{
"familyName": "Wakefield",
"givenName": "Robin"
}, {
"familyName": "Miller",
"givenName": "Ben"
}],
"children": [{
"familyName": "Merriam",
"givenName": "Jesse",
"gender": "female",
"grade": 1,
"pets": [{
"givenName": "Goofy"
}, {
"givenName": "Shadow"
}]
}, {
"familyName": "Miller",
"givenName": "Lisa",
"gender": "female",
"grade": 8
}],
"address": {
"state": "NY",
"county": "Manhattan",
"city": "NY"
},
"creationDate": 1431620462,
"isRegistered": false
}
Consulta 6 de ejemplo
La consulta siguiente devuelve todas las familias en las que los grados de los elementos secundarios son 8.
Consultar
db.families.find( { children : { $elemMatch: { grade : 8 }} } )
Resultados
{
"_id": ObjectId("58f65e1198f3a12c7090e68c"),
"id": "WakefieldFamily",
"parents": [{
"familyName": "Wakefield",
"givenName": "Robin"
}, {
"familyName": "Miller",
"givenName": "Ben"
}],
"children": [{
"familyName": "Merriam",
"givenName": "Jesse",
"gender": "female",
"grade": 1,
"pets": [{
"givenName": "Goofy"
}, {
"givenName": "Shadow"
}]
}, {
"familyName": "Miller",
"givenName": "Lisa",
"gender": "female",
"grade": 8
}],
"address": {
"state": "NY",
"county": "Manhattan",
"city": "NY"
},
"creationDate": 1431620462,
"isRegistered": false
}
Consulta 7 de ejemplo
La consulta siguiente devuelve todas las familias en las que el valor de tamaño de la matriz secundaria es 3.
Consultar
db.Family.find( {children: { $size:3} } )
Resultados
No se ha devuelto ningún resultado ya que no hay familias con más de dos hijos. Solo si el parámetro es 2, esta consulta se realizará correctamente y devolverá el documento completo.
Pasos siguientes
En este tutorial, ha hecho lo siguiente:
- Aprendió a consultar mediante la API de Cosmos DB para MongoDB
Ahora puede continuar con el tutorial siguiente para obtener información sobre cómo distribuir sus datos globalmente.