Öğ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:

Ö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?

Sorgular, uygulamanın Veri Gezgini ve Azure portal ve REST API aracılığıyla çalıştır.

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

• SQL sorgusu ve SQL sözdizimi

Önkoşullar

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

Örnek sorgu 1

Yukarıdaki örnek aile belgesine göre, aşağıdaki SQL kimlik alanı ile eşleşen belgeleri WakefieldFamily döndürür. 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 kimlikleri ile eşleşen tüm verilen çocuk adlarını WakefieldFamily döndürür.

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:

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

Azure Cosmos DB'ye geçiş için kapasite planlaması yapmaya mı çalışıyorsunuz? Kapasite planlaması için mevcut veritabanı kümeniz hakkında bilgi kullanabilirsiniz.

• Mevcut veritabanı kümenizin sanal çekirdek ve sunucu sayısı hakkında tek bilginiz varsa, sanal çekirdek veya vCPUS kullanarak istek birimlerini tahmin hakkında bilgi edinebilirsiniz
• Geçerli veritabanı iş yükünüz için tipik istek oranlarını biliyorsanız Azure Cosmos DB kapasite planlayıcısı kullanarak istek birimlerini tahmin hakkında bilgi edinin