Tutorial: consultar dados no Azure Cosmos DB for NoSQL

APLICA-SE A: NoSQL

Azure Cosmos DB for NoSQL suporta à consulta de documentos usando a sintaxe de consulta interna. Este artigo fornece um exemplo de documento e dois exemplos de consultas e resultados.

Este artigo aborda as seguintes tarefas:

• Consulta dados NoSQL com a sintaxe de consulta integrada

Prerequisites

• Uma conta, um banco de dados e um contêiner do Azure Cosmos DB. Se você não tiver esses recursos, consulte Criar uma conta, banco de dados, contêiner e itens do Azure Cosmos DB no portal do Azure.

Você pode executar as consultas usando o Azure Cosmos DB Explorer no portal do Azure. Você também pode executar consultas usando a API REST ou vários SDKs.

Para obter mais informações sobre consultas, consulte Consultas no Azure Cosmos DB para NoSQL.

Documento de exemplo

As consultas neste artigo usam o seguinte exemplo de documento.

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

Selecionar todos os campos e aplicar um filtro

Dado o exemplo de documento da família, a consulta a seguir retorna os documentos em que o campo ID corresponde a WakefieldFamily. Por se tratar de uma instrução SELECT *, a saída da consulta será todo o documento JSON:

Query:

SELECT * 
FROM Families f 
WHERE f.id = "WakefieldFamily"

Results:

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

Selecione um produto cruzado de um campo da coleção filho

A consulta a seguir retorna todos os nomes dos filhos na família cuja ID corresponde a WakefieldFamily.

Query:

SELECT c.givenName 
FROM Families f 
JOIN c IN f.children 
WHERE f.id = 'WakefieldFamily'

Results:

[
  {
    "givenName": "Jesse"
  },
  {
    "givenName": "Lisa"
  }
]

Próxima etapa

Distribuir os dados globalmente