KQL sorgu kümesindeki verileri sorgulama

Bu makalede KQL sorgu kümesini kullanmayı öğreneceksiniz. KQL sorgu kümesi, Eventhouse, KQL veritabanı ve daha fazlası gibi farklı veri kaynaklarından gelen veriler üzerinde sorgu sonuçlarını çalıştırmak, görüntülemek ve özelleştirmek için kullanılan öğedir.

Azure İzleyici Log Analytics çalışma alanından veya Application Insights kaynağından alınan verilerle hizmetler arası sorgular gerçekleştirmek için bir KQL sorgu kümesi de kullanabilirsiniz.

KQL Sorgu Kümesi sorgu oluşturmak için Kusto Sorgu Dili kullanır ve ayrıca birçok SQL işlevini destekler. Sorgu dili hakkında daha fazla bilgi için bkz. Kusto Sorgu Diline genel bakış.

Önkoşullar

• Microsoft Fabric özellikli kapasiteye sahip bir çalışma alanı
• Düzenleme izinlerine ve verilerine sahip bir KQL veritabanı veya AllDatabaseAdmin izinlerine sahip bir Azure Veri Gezgini kümesi ve veritabanı.

Veri kaynağı seçme

Sorgular bir veri kaynağı bağlamında çalıştırılır. İlişkili veri kaynağını istediğiniz zaman değiştirebilir ve sorgu düzenleyicisinde kaydedilen sorguları koruyabilirsiniz. KQL sorgu kümenizi KQL veritabanı, Azure Veri Gezgini kümesi veya Azure İzleyici gibi farklı türlerdeki birden çok veri kaynağıyla ilişkilendirebilirsiniz.

İstediğiniz veri kaynağı türüne karşılık gelen sekmeyi seçin.

Eventhouse / KQL Veritabanı

1. KQL sorgu kümenizi açın.

2. Gezgin bölmesinde, arama çubuğunun altında veritabanı değiştiricisini açın ve Veri kaynağı> ekleEventhouse / KQL Veritabanı'nı seçin.

   

3. OneLake katalog penceresinde, KQL sorgu kümenize bağlanmak için bir KQL veritabanı seçin ve ardından Bağlan'ı seçin.

   Alternatif olarak, onelake veri hub'ı penceresini kapatın ve farklı bir veri kaynağına bağlanmak için + Veri kaynağı ekle menüsünü kullanın.

Azure Veri Gezgini

1. KQL sorgu kümenizi açın.

2. Gezgin bölmesinde, arama çubuğunun altında veritabanı değiştiricisini açın ve Veri kaynağı> ekleAzure Veri Gezgini'ni seçin.

   

3. Bağlantı URI'sinin altına küme URI'sini girin.

   Bağlantı URI'sini bulmak için Azure portalında küme kaynağınıza gidin. Bağlantı URI'si, Genel Bakış'ta bulunan URI'dir.

   

   Ücretsiz örnek küme eklemek için Bağlantı URI'si olarak "help" değerini belirtin.

   

4. Veritabanı'nın altında listeyi genişletin ve bir veri kaynağı seçin.

5. Bağlan'ı seçin.

Azure İzleyici

1. KQL sorgu kümenizi açın.

2. Gezgin bölmesindeki arama çubuğunun altında veritabanı değiştiricisini açın ve Veri kaynağı> ekleAzure İzleyici>Application Insights veya Log Analytics'i seçin.

   

3. Bağlantı parametrelerinizi veya tam bağlantı URI'nizi girin:

   

   Bağlantı parametrelerinizi girmek için:

   1. Abonelik Kimliğinizi girin. Kimliği Azure portalında Abonelikler'i> seçerek aboneliğinizin adını > bulabilir ve kaynak Genel Bakış sekmesinden Abonelik Kimliğini kopyalayabilirsiniz.

   2. Açılan listeden Kaynak Grubunu seçin. Application Insights veya Log Analytics kaynağınızı içeren kaynak grubunu seçin.

   3. Log Analytics için Çalışma Alanı Adı'nı veya Application Insights için Application Insights uygulama adını girin. Adı Azure portalında Application Insights veya Log Analytics kaynağını seçerek bulabilirsiniz.

   4. Açılan listeden Application Insights veya Log Analytics kaynağını seçin. Bu liste, seçtiğiniz kaynak grubundaki kaynaklarla doldurulur.

   Tam bağlantı URI'sini girmek için:

   1. Bağlantı URI'nizi seçin ve Bağlantı URI'nizi şu biçimde girin:

   Subscription-id<, resource-group-name> ve <ai-app-name> değerlerini kendi değerlerinizle değiştirin<>.

   Log Analytics için: https://ade.loganalytics.io/subscriptions/<subscription-id>/resourcegroups/<resource-group-name>/providers/microsoft.insights/components/<ai-app-name>

   Application Insights için: https://ade.applicationinsights.io/subscriptions/<subscription-id>/resourcegroups/<resource-group-name>/providers/microsoft.insights/components/<ai-app-name>

4. Bir Veritabanı seçin. Listeyi genişletin ve bir veritabanı seçin.

5. Bağlan'ı seçin.

Bu veri kaynağıyla ilişkilendirilmiş tabloların listesi, veri kaynağı adının altında görünür.

Sorgu yazma

Artık veri kaynağınıza bağlandığınıza göre, bu veriler üzerinde sorgu çalıştırabilirsiniz. KQL Sorgu Kümesi, erişiminiz olan herhangi bir veri kaynağından verileri sorgulamak için Kusto Sorgu Dili'ni (KQL) kullanır. KQL hakkında daha fazla bilgi edinmek için bkz. Kusto Sorgu Diline genel bakış.

Aşağıdaki örneklerde adresinde https://kustosamples.blob.core.windows.net/samplefiles/StormEvents.csvgenel kullanıma sunulan veriler kullanılır.

1. KQL sorgu kümesinin üst bölmesinde bir sorgu yazın veya kopyalayın.

2. Çalıştır düğmesini seçin veya sorguyu çalıştırmak için Shift+Enter tuşuna basın.

   Sonuçta elde edilen sorgu çıkışı, sorgu bölmesinin altında görünen sonuçlar kılavuzunda görüntülenir. Sorgunun başarıyla tamamlandığını ve sorgu sonuçlarını hesaplamak için kullanılan süreyi gösteren yeşil denetime dikkat edin.

   

Uyarı

Sorgu yazmanıza yardımcı olması için Copilot'ı da kullanabilirsiniz. Daha fazla bilgi için bkz. KQL Sorguları Yazmak için Copilot.

Veri kaynaklarıyla etkileşim kurma

Veri kaynağı gezgini, içinde olduğunuz sorgu kümesi sekmesine bağlı veri kaynakları arasında geçiş yapmanızı sağlar.

Veri kaynağı gezgini bölmesinin üst kısmındaki Gezgin'in altında belirli bir veri kaynağını aramak için arama çubuğunu kullanabilirsiniz. Veri kaynağı bağlantıları menüsünü genişletmek için arama çubuğunun altındaki veritabanı değiştiriciyi de kullanabilirsiniz. Kullanmak istediğiniz veri kaynağını seçin. Sekme adı daha önce düzenlenmediyse, veri kaynağından sonra otomatik olarak adlandırılır.

Veri kaynağı gezgini bölmesinde iki bölüm vardır. Üst bölümde veri kaynağındaki tüm öğeler listelenir ve alt bölümde sorgu kümesindeki tüm kullanılabilir veri kaynakları gösterilir.

Veri kaynağındaki öğeler

Veri kaynağı gezgininin üst bölümünde, kullanmakta olduğunuz veri kaynağına dahil edilen tüm öğeler gösterilir.

• Tablolar
• Materyalize Edilmiş Görünümler
• Kısayol
• Işlev

Genişletmek istediğiniz öğenin solundaki > numaralı oku seçin. Sonraki liste düzeylerindeki öğelerin solundaki ok > seçerek daha fazla ayrıntı göstermek için detaya gidebilirsiniz. Örneğin, tablolaraltında, tablonun solundaki oku seçerek tablodaki sütunların listesini gösterin.

Eylem menüsünü açmak için, genişletilmiş listedeki bir öğenin üzerine gelin ve Diğer menüsünü [...] seçin. Menüde aşağıdaki seçenekler gösterilir:

• Veritabanını yenile
• Veri profilini görüntüleme
• Verileri inceleme
• Ekle: Betik oluşturup kopyalamak için
• Veri alma: Yeni veri kaynağı eklemek için
• Pano oluşturma
• Tabloyu silme

Farklı öğe türleri için farklı eylemler kullanılabilir.

Kullanılabilir veri kaynakları

Veri kaynağı gezgininin alt bölümünde sorgu kümesine eklenen tüm kullanılabilir veri kaynakları gösterilir.

Eylem menüsünü açmak için, veri kaynağı adının üzerine gelin ve Diğer menüsünü [...] seçin. Menüde aşağıdaki seçenekler gösterilir:

• Veritabanını yenile
• Bu veritabanını kullan: Geçerli sekmede bu veri kaynağını kullanmak için geçiş yapın
• Yeni sekmede sorgu: Bu veri kaynağını sorgu kümesindeki yeni bir sekmede açın
• Kaynağı kaldır: Bu veri kaynağındaki tüm veritabanlarını kaldırır
• Veritabanını kaldır: Yalnızca seçili veritabanını kaldırır
• KQL veritabanında aç: Bu veri kaynağını bir KQL veritabanında açar.

Sorgu kümesi sekmelerini yönetme

KQL sorgu kümesinde birden çok sekme oluşturabilirsiniz. Her sekme farklı bir KQL veritabanıyla ilişkilendirilebilir ve daha sonra kullanmak üzere sorguları kaydetmenize veya veri keşfi üzerinde işbirliği yapmak üzere başkalarıyla paylaşmanıza olanak tanır. Ayrıca, farklı veritabanlarındaki verilerde aynı sorguyu çalıştırmanıza olanak tanıyarak herhangi bir sekmeyle ilişkili KQL veritabanını değiştirebilirsiniz.

Sekmelerinizi aşağıdaki yollarla yönetebilirsiniz:

• Var olan veri kaynağı bağlantısını değiştirme: Gezgin ve arama çubuğunun altında, veri kaynağı bağlantıları menüsünü genişletmek için veritabanı değiştiricisini kullanın.
• bir sekmeyi yeniden adlandırın: Sekme adının yanında,kalem simgesini seçin.
• Yeni sekme ekle: Komut çubuğundaki mevcut sekmelerin sağında artı +öğesini seçin. Farklı veri kaynaklarına farklı sekmeler bağlanabilir.
• Diğer eylemler: Komut çubuğunun sağ tarafında, sorgu kümenizdeki birden çok sekmeyi yönetmek için daha fazla eylem içeren bir sekme menüsü bulunur.
• Sekme konumlarını değiştirme: Sürükle ve bırak hareketlerini kullanın.

KQL sorgu kümesini sil

KQL sorgu kümenizi silmek için:

1. KQL sorgu kümenizin bulunduğu çalışma alanını seçin.

2. Silmek istediğiniz KQL sorgu kümesi üzerine gelin. Diğer [...] öğesini ve ardından Sil'i seçin.

   

Sonraki adım

KQL Sorgu Kümesi sonuçları kılavuzunda sonuçları özelleştirme