Tutorial: Consultar dados no Azure Cosmos DB para NoSQL

  • Artigo

APLICA-SE A: NoSQL

O Azure Cosmos DB para NoSQL suporta a consulta de documentos com a sintaxe de consulta incorporada. Este artigo fornece um documento de exemplo e duas consultas e resultados de exemplo.

Este artigo abrange as seguintes tarefas:

  • Consultar dados NoSQL com a sintaxe de consulta incorporada

Pré-requisitos

Este tutorial pressupõe que tem uma conta, base de dados e contentor do Azure Cosmos DB.

Não tem nenhum desses recursos? Conclua este início rápido: criar uma conta, base de dados, contentor e itens do Azure Cosmos DB a partir do portal do Azure.

Pode executar as consultas com o Explorador do Azure Cosmos DB no portal do Azure. Também pode executar consultas com a API REST ou vários SDKs.

Para obter mais informações sobre consultas, consulte Definição iniciada com consultas.

Documento de exemplo

As consultas neste artigo utilizam o documento de exemplo seguinte.

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

Tendo em conta o documento de família de exemplo, a seguinte consulta devolve os documentos em que o campo ID corresponde WakefieldFamilya . Uma vez que é uma declaração SELECT *, o resultado da consulta é o documento JSON completo:

Consulta:

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

Resultados:

{
  "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 um produto cruzado de um campo de coleção subordinada

A consulta seguinte devolve todos os nomes de menores da família cujo ID corresponde WakefieldFamilya .

Consulta:

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

Resultados:

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

Passos seguintes

Neste tutorial, fez as seguintes tarefas:

  • Aprendeu a consultar com a sintaxe de consulta incorporada

Agora pode avançar para o tutorial seguinte para saber como distribuir dados globalmente.

Distribuir dados globalmente