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.
- Azure Veri Gezgini panoları ile verileri görselleştirme
- Azure Veri Gezgini panosunda düzenleyici izinleri
- Görseller içeren bir pano
Tüm pano parametrelerinin listesini görüntülemek için panonun üst kısmındaki Parametreler düğmesini seçin.
Parametre oluşturmak için:
Görüntüleme modundan Düzenleme moduna geçin.
Panonun üst kısmındaki Parametreler düğmesini seçin.
Sağ bölmenin üst kısmındaki + Yeni parametre düğmesini seçin.
Parametreniz için ilgili özellikleri doldurun.
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:
|
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ğı:
|
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. |
Ü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.
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.
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.
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ığı.
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.
Parametreler bölmesini açmak için Parametreler'i seçin ve Yeni parametre'yi seçin.
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ı
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.
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.
Görselleri güncelleştirmek için farklı değerler seçin.
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.
Parametreler bölmesini açmak için Parametreler'i seçin ve Yeni parametre'yi seçin.
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
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.
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.
Görselleri güncelleştirmek için bir veya daha fazla farklı değer seçin.
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.
Parametreler bölmesini açmak için Parametreler'i seçin ve Yeni parametre'yi seçin.
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
Parametresini oluşturmak için Bitti'yi seçin.
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.
Görselleri güncelleştirmek için farklı değerler seçin.
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:
Parametreler bölmesini açmak için Parametreler'i seçin ve + Yeni parametre'yi seçin.
-
- 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
Parametresini oluşturmak için Bitti'yi seçin.
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.
Görselleri güncelleştirmek için bir veya daha fazla farklı değer seçin.
Serbest metin parametreleri herhangi bir değer içermez. Kendi değerinizi tanıtmanıza olanak sağlar.
Parametreler bölmesini açmak için Parametreler'i seçin ve + Yeni parametre'yi seçin.
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
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
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.
Parametreler bölmesini açmak için Parametreler'i seçin ve + Yeni parametre'yi seçin.
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
Bitti'yi seçin.
Yeni parametre artık panonun en üstündeki parametre listesinde görünür.
Yeni veya mevcut bir kutucuğun sorgusuna gidin.
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.
Değişiklikleri uygula'yı seçin.
Bu bağlı sorgunun veri kaynağını değiştirmek için Küme parametresini kullanın.
Ç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 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.
Çapraz filtreler eklemek istediğiniz kutucuğun sorgusuna gidin.
Görsel'i seçin.
Sağ bölmede Etkileşimler'i seçin ve çapraz filtreleri açın.
İ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.
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 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ı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 oluşturmak için önce görselde açmalı ve ardından gerektiği gibi bir veya daha fazla detaylandırma eklemelisiniz.
Detaylandırma eklemek istediğiniz görseli düzenleyin. Görsel sekmesinin seçili olduğundan emin olun.
Sağ bölmede Etkileşimler'i seçin ve detaylandırmayı açın.
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 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 filtresinde, istediğiniz değeri yazın. Filtre yalnızca arama terimiyle eşleşen değerleri gösterecek şekilde güncelleştirilir.