Consulta de los datos con la API de Azure Cosmos DB para MongoDB

SE APLICA A: 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 Azure Cosmos DB 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 realizar consultas mediante la API de Azure Cosmos DB for MongoDB

Ahora puede continuar con el tutorial siguiente para obtener información sobre cómo distribuir sus datos globalmente.