Azure Veri Gezgini panolarında parametreleri kullanma

Parametreler, Azure Veri Gezgini panolarındaki filtreler için yapı taşları olarak kullanılır. Bunlar pano kapsamında yönetilir ve temel alınan görsel tarafından sunulan verileri filtrelemek için sorgulara eklenebilir. Sorgu bir veya daha fazla parametre kullanabilir.

Bu belgede, panolarda parametrelerin ve bağlantılı filtrelerin oluşturulması ve kullanılması açıklanmaktadır. Parametreler, filtre çubuğunda parametre değerleri seçilerek veya çapraz filtreler kullanılarak pano görsellerini filtrelemek için kullanılabilir.

Bu makalede kullanılan sorgu örnekleri, örnekler galerisindeki StormEvents tabloyu temel alır.

Not

Parametre yönetimi, pano düzenleyicileri için Düzenleme modunda kullanılabilir.

Önkoşullar

• Azure Veri Gezgini panoları ile verileri görselleştirme
• Azure Veri Gezgini panosunda düzenleyici izinleri
• Görseller içeren bir pano

Parametre listesini görüntüleme

Tüm pano parametrelerinin listesini görüntülemek için panonun üst kısmındaki Parametreler düğmesini seçin.

Parametre oluşturma

Parametre oluşturmak için:

1. Görüntüleme modundan Düzenleme moduna geçin.

   

2. Panonun üst kısmındaki Parametreler düğmesini seçin.

   

3. Sağ bölmenin üst kısmındaki + Yeni parametre düğmesini seçin.

4. Parametreniz için ilgili özellikleri doldurun.

Desteklenen özellikler

Parametre ekle bölmesinde aşağıdaki özellikleri yapılandırın:

Alan	Açıklama
Etiket	Panoda veya düzenleme kartında gösterilen parametrenin adı.
Parametre türü	Aşağıdaki parametrelerden biri: Tek seçim: Filtrede parametre için giriş olarak yalnızca bir değer seçilebilir. Birden çok seçim: Filtrede parametre için giriş olarak bir veya daha fazla değer seçilebilir. Zaman aralığı: Sorguları ve panoları zamana göre filtrelemek için ek parametreler oluşturmaya olanak tanır. Her panonun varsayılan olarak bir zaman aralığı seçicisi vardır. Serbest metin: Filtrede herhangi bir değer doldurulmuyor. Kullanıcı bir değer yazabilir veya metin alanına bir değer kopyalayabilir/yapıştırabilir. Filtre, kullanılan son değerleri tutar.
Değişken adı	Sorguda kullanılacak parametrenin adı. İpucu: Alt çizgi karakteri (_) gibi ayırt edici bir karaktere sahip değişken adlarının ön eklerinin bulunması, sorgu yazarken bunların bulunmasını kolaylaştırır.
Veri türü	Parametre değerlerinin veri türü.
Sayfalarda göster	Bu parametrenin görüntüleneceği sayfaları seçin. Tümünü seç seçeneği tüm sayfalarda parametresini gösterir.
Kaynak	Parametre değerlerinin kaynağı: Sabit değerler: Statik filtre değerleri el ile kullanıma sunulmuştur. Sorgu: KQL sorgusu kullanarak dinamik olarak tanıtılan değerler.
Varsayılan değer	Filtrenin varsayılan değeri. Filtre, panonun ilk işlenmesinden sonra her zaman varsayılan değerle başlar.
"Tümünü seç" değeri ekleme	Yalnızca tek seçim ve birden çok seçim parametresi türü için geçerlidir. Tüm parametre değerlerinin verilerini almak için kullanılır. İşlevselliği sağlamak için bu değer sorguda yerleşik olarak bulunmalıdır. Bu tür sorgular oluşturma hakkında daha fazla örnek için bkz . Çok seçimli sorgu tabanlı parametreyi kullanma.

Parametreleri yönetme

Üst çubuktan Parametreler'i seçtikten sonra mevcut parametrelerin listesini görüntüleyebilirsiniz. Her parametre kartında, parametreyi düzenlemek için kalem pencere öğesini seçin veya Diğer [...] menüsünü seçerek Parametreyi çoğaltın, silin veya taşıyın.

Parametre kartında aşağıdaki göstergeler görüntülenebilir:

• Parametre görünen adı
• Değişken adları
• Parametresinin kullanıldığı sorgu sayısı
• Parametrenin sabitlendiği sayfalar

Parametre kartları sürükleyip bırakılarak veya Taşı > seçeneği kullanılarak ve yeni konum seçilerek sıralanabilir.

Sorgunuzda parametreleri kullanma

Filtrenin bu sorgu görseli için geçerli olması için sorguda bir parametre kullanılmalıdır. Tanımlandıktan sonra, parametreleri Sorgu sayfası > filtre üst çubuğunda ve sorgu intellisense'te görebilirsiniz.

Not

Parametre sorguda kullanılmazsa, filtre devre dışı kalır. Parametre sorguya eklendikten sonra filtre etkin hale gelir.

Parametre türleri

Aşağıdaki gibi çeşitli pano parametre türleri desteklenir:

• Varsayılan zaman aralığı parametresi
• Tek seçimli sabit değerler parametreleri
• Birden çok seçimli sabit değerler parametreleri
• Tek seçimli sorgu tabanlı parametreler
• Birden çok seçimli sorgu tabanlı parametreler
• Serbest metin parametreleri
• Veri kaynağı parametreleri

Aşağıdaki örneklerde, çeşitli parametre türleri için bir sorguda parametrelerin nasıl kullanılacağı açıklanmaktadır.

Varsayılan zaman aralığı parametresi

Her panonun varsayılan olarak bir Zaman aralığı parametresi vardır. Panoda yalnızca sorguda kullanıldığında filtre olarak gösterilir. Parametre anahtar sözcüklerini _startTime kullanın ve _endTime aşağıdaki örnekte görüldüğü gibi sorguda varsayılan zaman aralığı parametresini kullanın:

StormEvents
| where StartTime between (_startTime.._endTime)
| summarize TotalEvents = count() by State
| top 5 by TotalEvents

Kaydedildikten sonra, zaman aralığı filtresi panoda gösterilir. Artık kart üzerindeki verileri filtrelemek için kullanılabilir. Açılan listeden seçim yaparak panonuzu filtreleyebilirsiniz: Zaman aralığı (son x dakika/saat/gün) veya Özel zaman aralığı.

Tek seçimli sabit değerler parametreleri

Sabit değer parametreleri, kullanıcı tarafından belirtilen önceden tanımlanmış değerleri temel alır. Aşağıdaki örnekte tek bir seçim sabit değer parametresinin nasıl oluşturulacağı gösterilmektedir.

Tek seçimli sabit değerler parametresi oluşturma

1. Parametreler bölmesini açmak için Parametreler'i seçin ve Yeni parametre'yi seçin.

2. Ayrıntıları aşağıdaki gibi doldurun:

   • Etiket: Olay Türü

   • Parametre türü: Tek seçim

   • Değişken adı: _eventType

   • Veri türü: Dize

   • Pano filtresi olarak sabitle: işaretli

   • Kaynak: Sabit değerler

     Bu örnekte aşağıdaki değerleri kullanın:

     Değer	Parametre görünen adı
     Gök Gürültülü Fırtına	Fırtına rüzgarı
     Dolu	Dolu
     Flash Flood	Ani sel
     Kuraklık	Kuraklık
     Kış Hava Durumu	Kış hava durumu

   • Tümünü seç değeri ekleme: İşaretsiz

   • Varsayılan değer: Fırtına Rüzgarı

3. Parametresini oluşturmak için Bitti'yi seçin.

Parametre Parametreler yan bölmesinde görülebilir, ancak şu anda hiçbir görselde kullanılmaz.

Tek seçimli sabit değerler parametresi kullanma

1. Değişken adını kullanarak yeni Event TypTope parametresini _eventType kullanarak bir örnek sorgu çalıştırın:

   StormEvents
   | where StartTime between (_startTime.._endTime)
   | where EventType == _eventType
   | summarize TotalEvents = count() by State
   | top 5 by TotalEvents
   

   Yeni parametre, panonun en üstündeki parametre listesinde gösterilir.

2. Görselleri güncelleştirmek için farklı değerler seçin.

   

Birden çok seçimli sabit değerler parametreleri

Sabit değer parametreleri, kullanıcı tarafından belirtilen önceden tanımlanmış değerleri temel alır. Aşağıdaki örnekte, birden çok seçimli bir sabit değerli parametrenin nasıl oluşturulacağı ve kullanılacağı gösterilmektedir.

Birden çok seçimli sabit değerler parametreleri oluşturma

1. Parametreler bölmesini açmak için Parametreler'i seçin ve Yeni parametre'yi seçin.

2. Tek seçimli sabit değerler parametresini kullanma bölümünde belirtildiği gibi ayrıntıları aşağıdaki değişikliklerle doldurun:

   • Etiket: Olay Türü
   • Parametre türü: Birden çok seçim
   • Değişken adı: _eventType

3. Parametresini oluşturmak için Bitti'yi seçin.

Yeni parametreler Parametreler yan bölmesinde görülebilir, ancak şu anda hiçbir görselde kullanılmaz.

Çoklu seçim sabit değerler parametresi kullanma

1. değişkenini kullanarak yeni Olay Türü parametresini _eventType kullanarak bir örnek sorgu çalıştırın.

   StormEvents
   | where StartTime between (_startTime.._endTime)
   | where EventType in (_eventType) or isempty(_eventType)
   | summarize TotalEvents = count() by State
   | top 5 by TotalEvents
   

   Yeni parametre, panonun en üstündeki parametre listesinde gösterilir.

2. Görselleri güncelleştirmek için bir veya daha fazla farklı değer seçin.

   

Tek seçimli sorgu tabanlı parametreler

Sorgu tabanlı parametre değerleri, parametre sorgusu yürütülerek pano yüklenirken alınır. Aşağıdaki örnekte, tek bir seçim sorgu tabanlı parametrenin nasıl oluşturulacağı ve kullanılacağı gösterilmektedir.

Tek seçimli sorgu tabanlı parametre oluşturma

1. Parametreler bölmesini açmak için Parametreler'i seçin ve Yeni parametre'yi seçin.

2. Tek seçimli sabit değerler parametresini kullanma bölümünde belirtildiği gibi ayrıntıları aşağıdaki değişikliklerle doldurun:

   • Etiket: Durum

   • Değişken adı: _state

   • Kaynak: Sorgu

   • Veri kaynağı: StormEventsSample

   • Sorguyu düzenle'yi seçin ve aşağıdaki sorguyu girin. Bitti'yi seçin.

     StormEvents
     | where StartTime between (_startTime.._endTime)
     | where EventType in (_eventType) or isempty(_eventType)
     | summarize TotalEvents = count() by State
     | top 5 by TotalEvents
     | project State
     

   • Değer: Durum

   • Görünen ad: Durum

   • Varsayılan değer: Varsayılan bir değer seçin

3. Parametresini oluşturmak için Bitti'yi seçin.

Tek seçimli sorgu tabanlı parametre kullanma

1. Yeni State parametresiyle aşağıdaki örnek sorgu değişkeni kullanır _state :

   StormEvents
   | where StartTime between (_startTime.._endTime)
   | where EventType in (_eventType) or isempty(_eventType)
   | where State == _state
   | summarize TotalEvents = count() by State
   | top 5 by TotalEvents
   

   Yeni parametre, panonun en üstündeki parametre listesinde gösterilir.

2. Görselleri güncelleştirmek için farklı değerler seçin.

Birden çok seçimli sorgu tabanlı parametreler

Sorgu tabanlı parametre değerleri, kullanıcı tarafından belirtilen sorgu yürütülerek pano yükleme zamanında türetilir. Aşağıdaki örnekte, birden çok seçimli sorgu tabanlı parametrenin nasıl oluşturulacağı gösterilmektedir:

Çok seçimli sorgu tabanlı parametre oluşturma

1. Parametreler bölmesini açmak için Parametreler'i seçin ve + Yeni parametre'yi seçin.

2. 1. Tek seçimli sabit değerler parametresini kullanma bölümünde belirtildiği gibi ayrıntıları aşağıdaki değişikliklerle doldurun:
   • Etiket: Durum
   • Parametre türü: Birden çok seçim
   • Değişken adı: _state

3. Parametresini oluşturmak için Bitti'yi seçin.

Birden çok seçimli sorgu tabanlı parametre kullanma

1. Aşağıdaki örnek sorgu, değişkenini kullanarak yeni State parametresini _state kullanır.

   StormEvents
   | where StartTime between (_startTime.._endTime)
   | where EventType in (_eventType) or isempty(_eventType)
   | where State in (_state) or isempty(_state)
   | summarize TotalEvents = count() by State
   | top 5 by TotalEvents
   

   Not

   Bu örnek, işleviyle isempty() boş değerleri denetleyerek Tümünü Seç seçeneğini kullanır.

   Yeni parametre, panonun en üstündeki parametre listesinde gösterilir.

2. Görselleri güncelleştirmek için bir veya daha fazla farklı değer seçin.

Serbest metin parametreleri

Serbest metin parametreleri herhangi bir değer içermez. Kendi değerinizi tanıtmanıza olanak sağlar.

Serbest metin parametresi oluşturma

1. Parametreler bölmesini açmak için Parametreler'i seçin ve + Yeni parametre'yi seçin.

2. Ayrıntıları aşağıdaki gibi doldurun:

   • Etiket: Durum
   • Parametre türü: Serbest metin
   • Değişken adı: _state
   • Veri türü: Dize
   • Varsayılan değer: Varsayılan değer yok

Serbest metin parametresi kullanma

1. Değişken adını kullanarak yeni State parametresini _state kullanarak bir örnek sorgu çalıştırın:

   StormEvents
   | where StartTime between (_startTime.._endTime)
   | where EventType in (_eventType) or isempty(_eventType)
   | where State contains _state
   | summarize TotalEvents = count() by State
   | top 5 by TotalEvents
   

Veri kaynağı parametreleri

Panonuza veri kaynakları ekledikten sonra, kullanılabilir veri kaynaklarından birini veya daha fazlasını seçen bir parametre oluşturabilirsiniz. Bu parametre kutucuklarda ve diğer parametrelerde kullanılabilir.

Veri kaynağı parametresi oluşturma

1. Parametreler bölmesini açmak için Parametreler'i seçin ve + Yeni parametre'yi seçin.

2. Ayrıntıları aşağıdaki gibi doldurun:

   • Etiket: Kaynak
   • Parametre türü: Veri kaynağı
   • Sayfalarda göster: Tümünü seç
   • Değerler: Tümünü seç
   • Varsayılan değer: StormEventsSample

3. Bitti'yi seçin.

Yeni parametre artık panonun en üstündeki parametre listesinde görünür.

Veri kaynağı parametresi kullanma

1. Yeni veya mevcut bir kutucuğun sorgusuna gidin.

2. Kaynak'ta, Veri kaynağı parametreleri'nin altında yeni parametrenizin adını seçin. Yukarıda oluşturulan parametre için Küme'yi seçin.

3. Değişiklikleri uygula'yı seçin.

4. Bu bağlı sorgunun veri kaynağını değiştirmek için Küme parametresini kullanın.

Filtreler arası parametreler

Çapraz filtreler tek bir görselde bir değer seçmenize olanak tanır ve çizgi veya dağılım grafikleri gibi tüm pano görselleri yalnızca ilgili verileri gösterecek şekilde filtrelenir. Çapraz filtrelerin kullanılması, panonun en üstündeki parametre listesinde parametre için eşdeğer değerin seçilmesiyle aynı sonucu verir.

Çapraz filtreleri tanımlama

Çapraz filtre oluşturmak için görselde seçeneğini açmanız ve ardından verileri filtrelemek için kullanılan parametreyi belirtmeniz gerekir.

1. Çapraz filtreler eklemek istediğiniz kutucuğun sorgusuna gidin.

2. Görsel'i seçin.

3. Sağ bölmede Etkileşimler'i seçin ve çapraz filtreleri açın.

4. İsteğe bağlı olarak Etkileşim türünü belirtin. Varsayılan değer, görselde bir değer seçebileceğiniz Nokta'dır. Zaman grafiğinde olduğu gibi bir değer aralığı seçmek için Sürükle'yi seçin.

5. Hem değeri sağlamak için kullanılan sütunu hem de sorguyu filtrelemek için kullanılan parametreyi belirtin.

   Önemli

   Sütun ve parametre aynı veri türünde olmalıdır.

Çapraz filtre kullanarak verilerinizle etkileşim kurma

Çapraz filtre tanımlandıktan sonra, verilerinizle etkileşime geçmek için bu filtreyi kullanabilirsiniz. Çapraz filtreleri tanımladığınız görsellerde veri noktalarını seçebilir ve geçerli pano sayfasını filtrelemek için bunların değerlerini kullanabilirsiniz. Tablo görselleri için ilgili hücreye sağ tıklayarak veri noktalarını seçin ve bağlam menüsünde Çapraz filtre'yi seçin.

Görselin seçildiği üst kısımdaki Sıfırla'yı seçerek çapraz filtreyi sıfırlayabilirsiniz.

Detaylandırmaları pano parametreleri olarak kullanma

Detaylandırma ile görseldeki bir değeri seçebilir ve aynı panodaki hedef sayfadaki görselleri filtrelemek için kullanabilirsiniz. Hedef sayfa açıldığında, ilgili filtrelerde değer önceden seçilir. Sayfadaki çizgi veya dağılım grafikleri gibi görseller yalnızca ilgili verileri gösterecek şekilde filtrelenir.

Detaylandırma tanımlama

Detaylandırma oluşturmak için önce görselde açmalı ve ardından gerektiği gibi bir veya daha fazla detaylandırma eklemelisiniz.

1. Detaylandırma eklemek istediğiniz görseli düzenleyin. Görsel sekmesinin seçili olduğundan emin olun.

2. Sağ bölmede Etkileşimler'i seçin ve detaylandırmayı açın.

   

3. Detaylandırma'nın altında Yeni oluştur'u seçin ve aşağıdaki bilgileri belirtin. İsteğe bağlı olarak, hedef sayfaya birden çok parametre eklemek için Başka bir çift ekle'yi seçin. Farklı parametreler kullanarak geçerli panodaki diğer sayfalara detaylandırma eklemek için bu adımı yineleyin.

   Alan	Açıklama
   Hedef sayfa	Tanımlanan parametreleri kullanarak detaylandırmak için bir veya daha fazla hedef sayfa.
   Sütun	Hedef sayfadaki bir parametrenin değeri olarak kullanılacak sorgu sonucunun sütunu.
   Parametre	Sütun değerini kullanarak hedef sayfadaki görselleri filtrelemek için kullanılan parametre.
   Notlar	İsteğe bağlı kısa açıklama.

   Önemli

   Sütun ve parametre çiftleri aynı veri türünde olmalıdır.

Detaylandırmaları kullanarak verilerinizle etkileşim kurma

Detaylandırmalar tanımlandıktan sonra bunları kullanarak verilerinizle etkileşim kurabilirsiniz. Bunu yapmak için detaylandırma tanımladığınız görsellerde veya tablolarda bir veri noktasına sağ tıklayın ve ardından Hedef sayfaya detaylandırma'yı>seçin. Veri noktasındaki değerler, hedef sayfadaki görselleri filtrelemek için parametreler olarak kullanılır.

Kaynak sayfaya dönmek için, hedef sayfanın sağ üst kısmında Sıfırla'yı seçin. Detaylandırma tarafından atanan tüm filtreler sıfırlanır.

Tek ve birden çok seçim filtresi için filtre aramasını kullanma

Tek ve birden çok seçim filtresinde, istediğiniz değeri yazın. Filtre yalnızca arama terimiyle eşleşen değerleri gösterecek şekilde güncelleştirilir.

İlgili içerik

• Azure Veri Gezgini pano görsellerini özelleştirme
• Web kullanıcı arabiriminde Kusto Sorgu Dili sorguları yazma