Öğretici: SQL API’sini kullanarak Azure Cosmos DB’yi sorgulama

UYGULANDıĞı YER: SQL API

Azure Cosmos DB SQL API’si, SQL kullanılarak belgelerin sorgulanmasını destekler. Bu makalede, örnek bir belge ve iki örnek SQL sorgusu ve sonuçları sağlanmaktadır.

Bu makale aşağıdaki görevleri kapsar:

  • SQL ile verileri sorgulama

Örnek belge

Bu makaledeki SQL sorguları aşağıdaki örnek belgeyi kullanır.

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

SQL sorgularını nerede çalıştırabilirim?

Mevcut örnek veri kümesinde sorgular çalıştıran Sorgu oyun alanı ve REST API’si ve SDK’ları aracılığıyla, Azure portalındaki Veri Gezgini’ni kullanarak sorgular çalıştırabilirsiniz.

SQL sorguları hakkında daha fazla bilgi için bkz:

Önkoşullar

Bu öğreticide, bir Azure Cosmos DB hesabınız ve koleksiyonunuz olduğu varsayılır. Bu kaynaklardan hiçbiri yok mu? 5 dakikalık hızlı başlangıcı tamamlayın.

Örnek sorgu 1

Yukarıdaki örnek aile belgesi verildiğinde, SQL sorgusu, KIMLIK alanının eşleştiği belgeleri döndürür WakefieldFamily . Bu bir SELECT * deyimi olduğundan, sorgunun çıkışı eksiksiz JSON belgesidir:

Sorgu

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

Sonuçlar

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

Örnek sorgu 2

Sonraki sorgu, ailede KIMLIĞI eşleşen tüm alt öğelerin verilen adlarını döndürür WakefieldFamily .

Sorgu

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

Sonuçlar

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

Sonraki adımlar

Bu öğreticide, aşağıdaki görevleri tamamladınız:

  • SQL kullanarak sorgulamayı öğrendiniz

Artık verilerinizi genel olarak nasıl dağıtacağınızı öğrenmek için sonraki öğreticiye ilerleyebilirsiniz.