Esercitazione: Eseguire query sui dati in Azure Cosmos DB per NoSQL

SI APPLICA A: NoSQL

Azure Cosmos DB per NoSQL supporta l'esecuzione di query sui documenti usando la sintassi di query predefinita. Questo articolo include un documento di esempio e due esempi di query e relativi risultati.

Questo articolo illustra le attività seguenti:

Prerequisiti

Questa esercitazione presuppone che si disponga di un account, un database e un contenitore di Azure Cosmos DB.

Queste risorse non sono disponibili? Completare questa guida introduttiva: Creare un account, un database, un contenitore ed elementi di Azure Cosmos DB dal portale di Azure.

È possibile eseguire le query usando Azure Cosmos DB Explorer nel portale di Azure. È anche possibile eseguire query usando l'API REST o vari SDK.

Per altre informazioni sulle query, vedere Introduzione alle query.

Documento di esempio

Le query di questo articolo usano il documento di esempio seguente.

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

Selezionare tutti i campi e applicare un filtro

Dato il documento della famiglia, la query seguente restituisce i documenti in cui il campo ID corrisponde a WakefieldFamily. Poiché si tratta di un'istruzione SELECT *, l'output della query è il documento JSON completo:

Query:

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

Risultati:

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

Selezionare un prodotto incrociato di un campo di raccolta figlio

La query successiva restituisce tutti i nomi specificati dei figli della famiglia il cui ID corrisponde a WakefieldFamily.

Query:

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

Risultati:

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

Passaggi successivi

In questa esercitazione verranno effettuate le attività seguenti:

È ora possibile passare all'esercitazione successiva per imparare a distribuire i dati a livello globale.