Samouczek: wykonywanie zapytań o dane w usłudze Azure Cosmos DB for NoSQL

Usługa Azure Cosmos DB for NoSQL obsługuje wykonywanie zapytań dotyczących dokumentów przy użyciu wbudowanej składni zapytań. Ten artykuł zawiera przykładowy dokument i dwa przykładowe zapytania i wyniki.

W tym artykule opisano następujące zadania:

Wymagania wstępne

• Konto, baza danych i kontener usługi Azure Cosmos DB. Jeśli nie masz tych zasobów, zobacz Tworzenie konta, bazy danych, kontenera i elementów usługi Azure Cosmos DB z witryny Azure Portal.

Zapytania można uruchamiać przy użyciu Eksploratora usługi Azure Cosmos DB w witrynie Azure Portal. Zapytania można również uruchamiać przy użyciu interfejsu API REST lub różnych zestawów SDK.

Aby uzyskać więcej informacji na temat zapytań, zobacz Zapytania w usłudze Azure Cosmos DB for NoSQL.

Przykładowy dokument

Zapytania w tym artykule korzystają z następującego przykładowego dokumentu.

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

Zaznacz wszystkie pola i zastosuj filtr

Biorąc pod uwagę przykładowy dokument dotyczący rodziny, następujące zapytanie zwraca dokumenty, w których pole identyfikatora jest zgodne z WakefieldFamily. Ponieważ jest to instrukcja SELECT *, dane wyjściowe zapytania są kompletnym dokumentem JSON:

Zapytanie:

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

Wyniki:

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

Wybierz krzyżowy produkt pola kolekcji podrzędnej

Następne zapytanie zwraca wszystkie podane nazwiska dzieci w rodzinie, których identyfikator jest zgodny z WakefieldFamily.

Zapytanie:

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

Wyniki:

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

Następny krok