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 galerisindekiStormEvents 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 panosundaki 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
Etiketle	Panoda veya düzenleme kartında gösterilen parametrenin adı.
Parametre türü	Aşağıdaki parametrelerden biri: Tek seçim: Filtrede parametre girişi 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 izin verir. Her panonun varsayılan olarak bir zaman aralığı seçicisi vardır. Serbest metin: Filtrede doldurulmuş değer yok. Kullanıcı bir değer yazabilir veya metin alanına bir değer kopyalayabilir/yapıştırabilir. Filtre, kullanılan son değerleri korur.
Değişken adı	Sorguda kullanılacak parametrenin adı. İpucu: Değişken adlarının önüne alt çizgi karakteri (_) gibi ayırt edici bir karakter eklemek, sorgu yazarken daha kolay bulmalarını sağlar.
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 parametre 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ğerin sorguda yerleşik olarak yer alması gerekir. Bu tür sorgular oluşturmaya ilişkin daha fazla örnek için bkz. Çok seçimli sorgu tabanlı parametreyi kullanma.

Parametreleri yönet

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

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

• Parametre görünen adı
• Değişken adları
• Parametrenin 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örseline uygulanabilmesi için sorguda bir parametre kullanılmalıdır. Tanımlandıktan sonra, parametreleri Sorgu sayfası > filtre üst çubuğunda ve intellisense sorgusunda görebilirsiniz.

Not

Parametre sorguda kullanılmıyorsa, filtre etkin değil olarak 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
• Çoklu seçim sabit değerler parametreleri
• Tek seçimli sorgu tabanlı parametreler
• Ç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. Aşağıdaki örnekte görüldüğü gibi bir sorguda varsayılan zaman aralığı parametresini kullanmak için ve _endTime parametre anahtar sözcüklerini _startTime 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 ve ardından 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ı
     Fırtına Rüzgarı	Fırtına rüzgarı
     Dolu	Dolu
     Flash Flood	Ani sel
     Kurak -lık	Kurak -lı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.

Parametresi 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 örnek bir 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.

Birden çok seçimli 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 seçeneğini belirleyin.

     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.

Ç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 seçeneğini belirleyin.

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

Veri kaynağı parametresi kullanma

1. Yeni veya var olan bir kutucuğun sorgusuna gidin.

2. Kaynak bölümünde, 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.

Çapraz filtreler parametreleri

Çapraz filtreler tek bir görselde 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 elde eder.

Çapraz filtreleri tanımlama

Çapraz filtre oluşturmak için görseldeki seçeneği etkinleştirmeniz 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 yerin üst kısmındaki 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 sonra gerektiğinde 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ındanHedef sayfayadetaylandı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 filtresine 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