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.

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 Dili genel bakış.

Önkoşullar

Veritabanı seçme

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

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

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

  2. Sorgu sayfasının sol tarafındaki bağlantı bölmesinde, Gezgin'in altında V'yi seçerek veritabanı bağlantıları menüsünü genişletin.

    Bağlı veritabanlarının listesini gösteren veritabanı menüsünün ekran görüntüsü.

  3. Kaynak bağla'nın altında OneLake veri hub'ı seçin.

  4. Görüntülenen OneLake veri hub'ı 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 +Veri kaynağı ekle menüsünü kullanarak farklı bir veri kaynağına bağlanın.

Bu veritabanıyla ilişkilendirilmiş tabloların listesi, bağlantı bölmesindeki veritabanı adının altında görünür.

Bağlantı bölmesini kullanarak veritabanlarıyla etkileşim kurma

Bağlantı bölmesi, sorgu kümesine bağlı veritabanlarına göz atmanızı ve bunlar arasında geçiş yapmanızı sağlar. Veritabanı bağlantıları menüsünü genişletmek için bağlantı bölmesindeki Veritabanı'nın altında V'yi seçin. Araştırmak istediğiniz veritabanını seçin. Bağlantı bölmesinde, seçili veritabanına dahil edilen aşağıdaki öğelerin dökümü gösterilir:

  • Tablolar
  • Gerçekleştirilmiş Görünüm
  • Kısayol
  • İşlevler

Bağlantı bölmesinde, her bölüme hangi öğelerin dahil olduğunu keşfedebilirsiniz. Eylem menüsünü açmak için öğenin üzerine gelin ve Diğer menüsünü [...] seçin. Menü şu seçeneklere sahiptir:

  • Verileri yenile
  • Veri profilini görüntüleme
  • Bir betik oluşturmak ve sorgu düzenleyicisine yapıştırmak için ekle
  • Delete

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

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 veritabanlarından verileri sorgulamak için Kusto Sorgu Dili (KQL) kullanır. KQL hakkında daha fazla bilgi edinmek için bkz. Kusto Sorgu Dili 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.

    Sorgunun sonuçlarını gösteren KQL Sorgu Kümesinin ekran görüntüsü. Hem sorgu hem de sonuçlar bölmesi vurgulanır.

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 herhangi bir sekmeyle ilişkili KQL veritabanını değiştirerek farklı durumlardaki verilerde aynı sorguyu çalıştırmanızı sağlayabilirsiniz.

KQL Sorgu Kümesindeki sekmeleri düzenleme seçeneklerinin ekran görüntüsü.

  • Yeni sekme ekle: Mevcut sekmelerin sağındaki artıyı + seçin. Farklı veritabanlarına farklı sekmeler bağlanabilir.
  • Sekmeyi yeniden adlandırma: Sekme adının yanındaki kalem simgesini seçin.
  • Sekme konumlarını değiştirme: Sürükle ve bırak hareketlerini kullanarak sekme konumlarını değiştirin.
  • Var olan veritabanı bağlantısını değiştirme: Gezgin'in altında veri hub'ını açmak için var olan veritabanı bağlantısını seçin.

Komut çubuğunun sağ tarafında, sorgu kümenizdeki birden çok sekmeyi yönetmeye yönelik ek eylemlerin bulunduğu bir menü vardır.

KQL Sorgu Kümesi'nde birden çok sekmeyi yönetmeye yönelik birden çok sekme menüsünün ekran görüntüsü.

Sorguyu kopyala

Oluşturduğunuz sorguları kopyalayıp paylaşmak isteyebilirsiniz.

  1. Sorgu penceresinin üst kısmında Giriş sekmesini seçin.

  2. Sorgu bölmesinde Sorguyu kopyala'yı seçin.

    Kopyalama sorgusu veya sorgu sonuçları seçeneğinin açılan listesini gösteren KQL Sorgu Kümesinin Yönet sekmesinin ekran görüntüsü.

    Aşağıdaki tabloda, bir sorgunun nasıl kopyalandığına ilişkin birçok seçenek özetlenmiştir.

    Eylem Açıklama
    Sorguyu kopyala Sorgu metnini kopyalayın.
    Panoya bağlantı Sorguyu çalıştırmak için kullanılabilecek derin bir bağlantı kopyalayın.
    Panoya bağlama ve sorgulama Sorguyu ve sorgu metnini çalıştırmak için kullanılabilecek bir bağlantı kopyalayın.
    Panoya bağlama, sorgulama ve sonuçlar Sorguyu, sorgu metnini ve sorgunun sonuçlarını çalıştırmak için kullanılabilecek bir bağlantı kopyalayın.
    Sonuçları kopyalama Sorgunun sonuçlarını kopyalayın.
  3. Yukarıdaki tablodan istediğiniz eylemi seçin.

  4. Microsoft Word, Microsoft Teams veya Outlook gibi düzenlemek veya paylaşmak için bu bilgileri yapıştırın.

    Önemli

    Sorgu bağlantısını alan kullanıcının sorguyu yürütmek ve sonuçları görüntülemek için temel alınan veriler için görüntüleme izinlerine sahip olması gerekir.

Sorgu verilerini CSV olarak dışarı aktarma

Sorgu çıktısını kopyalayıp yapıştırmak yerine, sorgu sonuçlarını da dışarı aktarabilirsiniz.

Bu, sorgu sonuçlarını içeren bir CSV dosyasını dışarı aktarmak için tek seferlik bir yöntemdir.

  1. Sorgu penceresinin üst kısmında Giriş sekmesini seçin.

    Sonuçları CSV'ye aktarmak için vurgulanan seçeneği gösteren KQL Sorgu Kümesinin Giriş sekmesinin ekran görüntüsü.

  2. Sorgu bölmesinde CSV'ye aktar'ı seçin.

  3. CSV dosyasını yerel olarak kaydedin.

KQL sorgu kümesi silme

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.

    KQL sorgu kümesini silmeyi gösteren Microsoft Fabric çalışma alanının ekran görüntüsü.

Sonraki adım