Oktatóanyag: Az Azure Cosmos DB lekérdezése az SQL API használatával

A KÖVETKEZŐKRE VONATKOZIK: SQL API

Az Azure Cosmos DB SQL API támogatja a dokumentumok SQL-lel való lekérdezését. Ebben a cikkben egy mintadokumentum, valamint két minta SQL-lekérdezés és azok eredménye található.

Ez a cikk a következő feladatokat mutatja be:

  • Adatok lekérdezése SQL használatával

Mintadokumentum

A cikkben szereplő SQL-lekérdezések a következő mintadokumentumot használják.

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

Hol futtathatok SQL-lekérdezéseket?

Az Azure Portalon az Adatkezelővel futtathat lekérdezéseket a REST API-n és az SDK-n keresztül. Emellett használhatja még a Tesztlekérdezéseket is, amelyek a mintaadatok meglévő készletén futtatnak lekérdezéseket.

További tudnivalók az SQL-lekérdezésekről:

Előfeltételek

Ez az oktatóanyag feltételezi, hogy rendelkezik egy Azure Cosmos DB-fiókkal és -gyűjteménnyel. Nem rendelkezik ezekkel az erőforrásokkal? Kövesse az 5 perces gyorsútmutató lépéseit.

1. példalekérdezés

A fenti minta családi dokumentum miatt a következő SQL-lekérdezés azokat a dokumentumokat adja vissza, amelyekben az azonosító mező megfelel WakefieldFamily . Mivel ez egy SELECT * utasítás, a lekérdezés kimenete a teljes JSON-dokumentum:

Lekérdezés

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

Results (Eredmények)

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

2. példalekérdezés

A következő lekérdezés a családban található azon gyermekek nevét adja vissza, amelyek AZONOSÍTÓjának egyeznie kell WakefieldFamily .

Lekérdezés

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

Results (Eredmények)

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

Következő lépések

Ebben az oktatóanyagban a következőket hajtotta végre:

  • Megismerte, hogyan végezhet lekérdezéseket az SQL használatával

Továbbléphet a következő oktatóanyagra, amelyben megismerheti, hogyan terjesztheti az adatait globálisan.