Consultar dados usando a API para MongoDB do Azure Cosmos DBQuery data by using Azure Cosmos DB's API for MongoDB

A API para MongoDB do Azure Cosmos DB dá suporte a consultas do MongoDB.The Azure Cosmos DB's API for MongoDB supports MongoDB queries.

Este artigo aborda as seguintes tarefas:This article covers the following tasks:

  • Consultando dados armazenados no banco de dados do Cosmos usando o shell do MongoDBQuerying data stored in your Cosmos database using MongoDB shell

Você pode começar usando os exemplos neste documento e assistindo ao vídeo Consultar o Azure Cosmos DB com o shell do MongoDB.You can get started by using the examples in this document and watch the Query Azure Cosmos DB with MongoDB shell video .

Exemplo de documentoSample document

As consultas neste artigo usam o seguinte exemplo de documento.The queries in this article use the following sample document.

{
  "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
}

Exemplo de consulta 1Example query 1

Com base no exemplo de documento de família acima, a consulta a seguir retorna os documentos cujo campo de id corresponde a WakefieldFamily.Given the sample family document above, the following query returns the documents where the id field matches WakefieldFamily.

ConsultaQuery

db.families.find({ id: "WakefieldFamily"})

ResultadosResults

{
"_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
}

Exemplo de consulta 2Example query 2

A próxima consulta retorna todos os filhos da família.The next query returns all the children in the family.

ConsultaQuery

db.families.find( { id: "WakefieldFamily" }, { children: true } )

ResultadosResults

{
"_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
  }
]
}

Exemplo de consulta 3Example query 3

A próxima consulta retorna todas as famílias registradas.The next query returns all the families that are registered.

ConsultaQuery

db.families.find( { "isRegistered" : true })

Resultados Nenhum documento retornará.Results No document will be returned.

Exemplo de consulta 4Example query 4

A próxima consulta retorna todas as famílias não registradas.The next query returns all the families that are not registered.

ConsultaQuery

db.families.find( { "isRegistered" : false })

ResultadosResults

 {
"_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

}}

Exemplo de consulta 5Example query 5

A próxima consulta retorna todas as famílias não registradas e cujo estado seja NY.The next query returns all the families that are not registered and state is NY.

ConsultaQuery

 db.families.find( { "isRegistered" : false, "address.state" : "NY" })

ResultadosResults

 {
"_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

}}

Exemplo de consulta 6Example query 6

A próxima consulta retorna todas as famílias das quais as notas dos filhos seja 8.The next query returns all the families where children grades are 8.

ConsultaQuery

 db.families.find( { children : { $elemMatch: { grade : 8 }} } )

ResultadosResults

 {
"_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

}}

Exemplo de consulta 7Example query 7

A próxima consulta retorna todas as famílias das quais o tamanho da matriz de filhos seja três.The next query returns all the families where size of children array is 3.

ConsultaQuery

  db.Family.find( {children: { $size:3} } )

ResultadosResults

Nenhum resultado é retornado, pois não há famílias com mais de dois filhos.No results will be returned as there are no families with more than two children. Somente quando o parâmetro for dois essa consulta será bem-sucedida e retornará o documento completo.Only when parameter is 2 this query will succeed and return the full document.

Próximas etapasNext steps

Neste tutorial, você fez o seguinte:In this tutorial, you've done the following:

  • Aprendeu a consultar usando a API para MongoDB do Cosmos DBLearned how to query using Cosmos DB’s API for MongoDB

Agora você pode prosseguir para o próximo tutorial e aprender a distribuir seus dados globalmente.You can now proceed to the next tutorial to learn how to distribute your data globally.