Aracılığıyla paylaş


Gösterge paneli parametreleriyle çalışmak

Bu makalede, AI/BI panolarında parametrelerin nasıl kullanılacağı açıklanmaktadır. Bunun yerine alan filtreleri hakkında bilgi edinmek istiyorsanız bkz . Alanlara göre filtreleme.

AI/BI pano parametreleri, çalışma zamanında farklı değerleri veri kümesi sorgularıyla değiştirmenizi sağlar. Bu sayede veriler sql sorgusunda toplanmadan önce tarihler ve ürün kategorileri gibi ölçütlere göre filtreleyerek daha verimli sorgulama ve hassas analize yol açar. Parametreler, panoları etkileşimli hale getirmek için filtre pencere öğeleriyle veya veri kümelerinin yeniden kullanılmasını kolaylaştırmak için görselleştirme pencere öğeleriyle kullanılabilir.

Pano yazarları veya düzenleyicileri veri kümelerine parametre ekler ve bunları pano tuvalinde bir veya daha fazla pencere öğesine bağlar. Görselleştirme pencere öğelerinde ayarlanan statik parametreler için değerler yazarlar veya düzenleyiciler tarafından ayarlanır. Filtre pencere öğelerinde kullanılan parametreler için pano görüntüleyicileri çalışma zamanında filtre pencere öğelerindeki değerleri seçerek verilerle etkileşimde bulunabilir. Bu etkileşim, ilişkili sorguları yeniden çalıştırır ve filtrelenen verilere göre görselleştirmeleri görüntüler.

Parametreler sorguyu doğrudan değiştirir ve bu güçlü olabilir. Veri kümesi alan filtreleri ayrıca parametrelere göre büyük veri kümelerinde pano etkileşimi, daha fazla özellik ve daha iyi performans sunabilir. Bkz. Filtreleri kullanma.

Sorguya parametre ekleme

Pano veri kümesine parametre eklemek için taslak panoda en azından CAN EDIT izinlerine sahip olmanız gerekir. Parametreleri doğrudan Veri sekmesindeki veri kümesi sorgularına ekleyebilirsiniz.

Gif aşağıdaki adımların bir örneğini gösterir.

Sorguya parametre eklemek için:

  1. İmlecinizi parametreyi sorgunuza yerleştirmek istediğiniz yere getirin.

  2. Parametre Ekle'e tıklayarak yeni bir parametre ekleyin.

    Bu, varsayılan adıyla parameteryeni bir parametre oluşturur. Varsayılan adı değiştirmek için sorgu düzenleyicisinde değiştirin. Sorgu düzenleyicisine bu söz dizimini yazarak da parametre ekleyebilirsiniz.

Sorgu parametresini düzenleme

Parametreyi düzenlemek için:

  1. Parametre adının yanındaki öğesine tıklayın Dişli simgesi . Parametre ayrıntıları iletişim kutusu görüntülenir ve aşağıdaki yapılandırma seçeneklerini içerir:

    • Anahtar Sözcük: Sorgudaki parametreyi temsil eden anahtar sözcük. Bu yalnızca sorgudaki metin doğrudan güncelleştirilerek değiştirilebilir.

    • Görünen ad: Filtre düzenleyicisindeki ad. Varsayılan olarak, başlık anahtar sözcükle aynıdır.

    • Tür: Desteklenen türler Dize, Tarih, Tarih ve Saat, Sayısal'dır.

      • Varsayılan tür Dize'dir.
      • Sayısal veri türü, Ondalık ve Tamsayı arasında bir değer belirtmenize olanak tanır. Varsayılan sayısal tür Ondalık'tır.
    • Birden çok seçime izin ver: Kullanıcıların çalışma zamanında birden çok parametre seçmesine izin vermek için onay kutusunu seçin.

      Not

      Bu seçim sorgunuzda ek bir değişiklik yapılmasını gerektirebilir. Bkz. Birden çok seçime izin verme.

  2. İletişim kutusunu kapatmak için kullanıcı arabiriminin başka bir bölümüne tıklayın.

Varsayılan parametre değerini ayarlama

Sorgunuzun çalışması için parametre adının altındaki metin alanına yazarak parametreniz için varsayılan bir değer seçin. Parametre değeri uygulanmış olarak sorgu sonuçlarının önizlemesini görüntülemek için sorguyu çalıştırın. Sorgunun çalıştırılması varsayılan değeri de kaydeder. Tuvalde bir filtre pencere öğesi kullanarak bu parametreyi ayarladığınızda, filtre pencere öğesinde yeni bir varsayılan değer belirtilmediği sürece varsayılan değer kullanılır. Bkz. Filtreleri kullanma.

Birden çok seçime izin ver

Birden çok seçime izin veren sorgular sorguya bir ARRAY_CONTAINS işlev içermelidir.

Aşağıdaki örnekte, çalışma zamanında sorguya eklemek üzere birden çok değer seçmenize olanak tanıyan bir SQL sorgusu gösterilmektedir. WHERE yan tümcesi ARRAY_CONTAINS işlevini kullanır. Bu işlev parametre anahtar sözcüğünü ve sütun adını bağımsız değişken olarak alır. Parametre, sorguya dizi olarak eklenebilmesi için birden çok değeri tutacak şekilde ayarlanmalıdır. Sorgu çalıştırıldığında her satır değerlendirilir ve l_quantity'ın :parameter'de en az bir değerle eşleştiği tüm satırlar sonuç kümesine dahil edilir.

SELECT
  *
FROM
  samples.tpch.lineitem
WHERE array_contains(:parameter, l_quantity)

Varsayılan değerleri ayarlamak için:

  1. Değerlerin listesine göre satırları filtrelemek için ARRAY_CONTAINS işlevini kullanan bir veri kümesi sorgusu yazın.

  2. Parametre adının yanındaki dişli simgesine tıklayın. SeçBirden çok seçime izin ver.

    Not

    Bu adım, parametrenin sorguya dizi olarak eklenmesini sağlar. ARRAY_CONTAINS işlevi birden çok seçim etkinleştirilmeden kullanılıyorsa bir hata oluşur.

  3. Görünen adın altındaki metin alanına bir değer yazın. Birden fazla değer girebilirsiniz. Sonrakini girmeden önce geçerli değeri seçin.

Varsayılan değerler düzenleyicide ayarlanır. Birden çok değer seçilir ve boşlukla ayrılır.

Tarih aralığı parametrelerini uygula

Bir aralık tanımlamak ve yalnızca bu aralık içindeki sonuçları döndürmek için parametreleri kullanabilirsiniz. Aşağıdaki parametre türlerinden birini seçtiğinizde, .min ve .max sonekleri tarafından belirlenen iki parametre oluşturursunuz:

  • Tarih Aralığı
  • Tarih ve Saat Aralığı

Aşağıdaki örnekte adlı date_parambir tarih aralığı parametresi oluşturan bir SQL sorgusu gösterilmektedir.

SELECT * FROM samples.tpch.lineitem
WHERE l_shipdate BETWEEN :date_param.min and :date_param.max

Tarih aralığı parametresi oluşturmak için:

  1. Parametre ekle'ye tıklayın.

  2. Parametre adının yanındaki öğesine tıklayın Dişli simgesi . Anahtar Sözcük ve Görünen adını girin. Ek veya .min sonekleri eklemeyin.max.

  3. Tür olarak Tarih Aralığı veya Tarih ve Saat Aralığı'nı seçin.

  4. Sorgunuza aralığı tanımlayan bir WHERE yan tümcesi ekleyin. Aralığı tanımlamak için BETWEEN ve .min değerleriyle bir .max yan tümcesi kullanın. Örneğin:

     WHERE date_col BETWEEN :date_param.min AND :date_param.max
    
  5. Varsayılan tarih değerlerini girin ve sorguyu çalıştırarak test edin. Geçen hafta veya geçen ay gibi önceden ayarlanmış seçenekleri belirlemek için takvim simgesini kullanın.

Sorgu tabanlı parametreler

Sorgu tabanlı parametreler, yazarların panodaki verileri keşfederken parametreleri ayarlarken aralarından seçim yapabilecekleri dinamik veya statik bir değer listesi tanımlamasına olanak tanır. Bunlar, tek bir filtre pencere öğesinde alan filtresi ve parametre filtresi birleştirilerek tanımlanır.

Sorgu tabanlı parametre oluşturmak için pano yazarı aşağıdaki adımları gerçekleştirir:

  1. Sonuç kümesi olası parametre değerlerinin listesiyle sınırlı olan bir veri kümesi oluşturun.
  2. Parametre kullanan bir veri kümesi sorgusu oluşturun.
  3. Tuvalde bir alana filtre ekleyen ve parametre kullanan bir filtre pencere öğesi yapılandırın.
    • Alanları yapılandırmaları, alanı istenen uygun parametre değerleri listesiyle kullanacak şekilde ayarlanmalıdır.
    • Parametreleri yapılandırması bir parametre değeri seçecek şekilde ayarlanmalıdır.

Not

Sorgu tabanlı parametrelerde kullanılan bir veri kümesi panodaki diğer görselleştirmelerde de kullanılıyorsa, görüntüleyicinin filtre seçimi tüm bağlı sorguları değiştirir. Bunu önlemek için, yazarların panodaki diğer görselleştirmelerde kullanılmayan sorgu tabanlı parametreler için ayrılmış bir veri kümesi oluşturması gerekir.

Adım adım sorgu tabanlı parametre ve görselleştirme eklemeyi gösteren öğretici için Sorgu tabanlı parametreleri kullanma bölümüne bakın.

Dinamik parametre listesi oluşturma

Görüntüleyicilerin parametre değerlerini seçmek için kullandığı açılan listeyi dolduran dinamik bir veri kümesi oluşturmak için, tek bir alan döndüren ve bu alandaki tüm değerleri içeren bir SQL sorgusu yazın. Bu alandaki tüm yeni değerler otomatik olarak parametre seçimi olarak eklenir. Örnek bir SQL sorgusu aşağıdaki gibidir:

 SELECT
    DISTINCT c_mktsegment
  FROM
    samples.tpch.customer

Statik parametre listesi oluşturma

Yalnızca veri kümenize sabit kodladığınız değerleri içeren statik bir veri kümesi oluşturabilirsiniz. Örnek sorgu aşağıdaki gibidir:

SELECT
  *
FROM
  (
    VALUES
      ('MACHINERY'),
      ('BUILDING'),
      ('FURNITURE'),
      ('HOUSEHOLD'),
      ('AUTOMOBILE')
  ) AS data(available_choices)

Sorgu parametresini kaldırma

Parametreyi kaldırmak için sorgunuzdan silin.

Statik pencere öğesi parametreleri

Statik pencere öğesi parametreleri doğrudan bir görselleştirme pencere öğesinde yapılandırılır ve yazarların aynı veri kümesini paylaşan görselleştirme pencere öğelerini ayrı ayrı parametreleştirmesine olanak tanır. Bu, aynı veri kümesinin tuvalde farklı görünümler sunmasını sağlar.

Bu bölümdeki örnek, samples.nyctaxi.trips tablosunu sorgulayan bir veri kümesini temel alır. Sağlanan sorgu her yolculuğun mesafesini döndürür ve teslim alma gününü veya Weekdayolarak Weekend kategorilere ayırır. Sorgu parametresi, teslim alma işleminin hafta içi mi yoksa hafta sonu mu gerçekleştiğine bağlı olarak sonuçları filtreler.

Sorgu metni aşağıdaki kod bloğunda sağlanır, ancak bu bölümdeki yönergeler statik pencere öğesi parametreleriyle yapılandırılmış ilişkili görselleştirmeleri ayarlamayla sınırlıdır. Veri kümesini parametrelerle ayarlama yönergeleri için bkz. Sorguya parametre ekleme.


  WITH DayType AS (
    SELECT
      CASE
        WHEN DAYOFWEEK(tpep_pickup_datetime) IN (1, 7) THEN 'Weekend'
        ELSE 'Weekday'
      END AS day_type,
      trip_distance
    FROM samples.nyctaxi.trips
  )
  SELECT day_type, trip_distance
  FROM DayType
  WHERE day_type = :day_type_param

Görselleştirmeye statik pencere öğesi parametresi eklemek için:

  1. Taslak pano tuvaline görselleştirme pencere öğesi ekleyin.

  2. Yeni pencere öğesi seçili durumdayken yapılandırma panelindeki Veri kümesi açılan listesinden parametreli veri kümesini seçin.

  3. Filtreleri göster'e tıklayın. Parametreleri içeren veri kümeleri için yapılandırma panelinde bir Parametreleri bölümü görüntülenir.

    Parametre seçme seçeneğini gösteren görselleştirme yapılandırma paneli.

  4. Parametreleri başlığının sağındaki artı işaretine tıklayın ve açılan listeden bir parametre seçin.

  5. Varsayılan olarak, parametre değeri Veri sekmesindeki sorguda ayarlanan değerleri yansıtır. Bu değeri tutabilir veya veri kümesiyle değiştirmek için yeni bir değer seçebilirsiniz. Yeni parametrenin uygulandığı görselleştirmeyi göstermek için metin alanından uzaklaşın.

  6. Panonuzu gözden geçirin.

    Aşağıdaki resimde iki görselleştirme pencere öğesi gösterilmektedir. Her biri statik pencere öğesi parametresine sahip bir histogram olarak yapılandırılır. Soldaki grafik, hafta içi günlerden itibaren seyahat mesafelerinin dağılımını, sağdaki grafik ise hafta sonları için aynı verileri gösterir. Her iki görselleştirme de aynı veri kümesini temel alır.

    İki histogram, açıklandığı gibi statik, pencere öğesi düzeyinde parametreler kullanacak şekilde yapılandırılmıştır.

Filtre koşulu kullanarak verileri karşılaştırma

Verilerin bir bölümündeki toplamaları tüm veri kümesine uygulanan toplamalarla karşılaştırmanıza olanak tanıyan bir filtre koşulu ekleyebilirsiniz.

Aşağıdaki örnek, belirtilen parametre değeri Allolan ve verilerde görünmeyen bir filtre koşulunu içerecek şekilde önceki sorguyu genişletir. Filtre koşulunun ilk bölümü, önceki örnektekiyle aynı şekilde çalışır ve day_typeWeekday veya Weekendolduğu sonuçlar için filtreleme yapılır. Filtre koşulunun ikinci bölümü, parametrenin belirli bir değere ayarlı olup olmadığını denetler, bu örnekte verilerde görünmeyen All. Veri kümesi düzenleyicisinde bu parametre için varsayılan değeri ayarladığınızda, ne Weekday ne de Weekend değer olarak geçirilmediğinde filtreyi etkin bir şekilde atlarsınız.


WITH DayType AS (
  SELECT
    CASE
      WHEN DAYOFWEEK(tpep_pickup_datetime) IN (1, 7) THEN 'Weekend'
      ELSE 'Weekday'
    END AS day_type,
    trip_distance
  FROM
    samples.nyctaxi.trips
)
SELECT
  day_type,
  trip_distance
FROM
  DayType
WHERE
  day_type = :day_type_param
  OR :day_type_param = 'All'

Üç görselleştirme aracını, sırasıyla day_type_param'un All, Weekday ve Weekend olarak ayarlandığı şekilde bu veri kümesiyle yapılandırabilirsiniz. Ardından pano görüntüleyicileri, gün türüne göre filtrelenen her veri kümesini tüm veri kümesiyle karşılaştırabilir.

Aşağıdaki GIF,bu sorguyla oluşturulan veri kümesinden nasıl hızlı bir şekilde üç grafik oluşturabileceğinizi gösterir.

  1. İlk grafik, bir parametre değeri Weekdayolarak ayarlanmış Seyahat Mesafelerini Gün Türüne göre veri kümesini gösterecek şekilde yapılandırılmıştır.
  2. Uygulanan tüm yapılandırmaları korumak için grafiği kopyalayabilirsiniz.
  3. Hafta sonu yapılan yolculukların verilerini göstermek için statik parametresini Hafta Sonu olarak ayarlayın.
  4. Daha önce uygulanan tüm yapılandırmaları korumak için yeni grafiği klonlar.
  5. Yeni grafikteki parametresini Tüm olarak ayarlayarak hafta sonu ve hafta içi yolculuklar için mesafeye göre toplam seyahat sayısını gösterin.

Önceki metinde açıklandığı gibi bir gif.

Panoda parametreleri gösterme

Pano tuvalinize filtre eklemek, izleyicilerin verileri etkileşimli olarak keşfetmek ve analiz etmek için parametre değerlerini seçmesine ve değiştirmesine olanak tanır. Parametreyi panoda kullanıma sunmazsanız, görüntüleyiciler yalnızca sorguda ayarladığınız varsayılan parametre değerini kullanan sorgu sonuçlarını görür.

Panonuza parametre eklemek için:

  1. Filtre ekle (alan/parametre) seçeneğine tıklayınFilter Icon.
  2. Yapılandırma panelinde add field iconParametreler yanındaki tıklayın.
  3. Görüntüleyicinin bu pencere öğesiyle kullanmasını istediğiniz parametre adına tıklayın.

Filtre pencere öğeleri ve statik parametrelerle çalışma

Parametreler, çalışma zamanında sorguyla değiştirilen sabit değerlerdir. Panonuz güncelleştirildiğinde aynı parametreye yönelik iki veya daha fazla başvuru farklı değerlerle ayarlanırsa görselleştirme pencere öğeleri hangi parametrenin çakışan değerlere sahip olduğunu belirten bir hata görüntüler. Bu durum, birden çok filtre pencere öğesi aynı parametreyi kullandığında veya statik parametre görüntüleyici seçimine izin veren bir filtre pencere öğesiyle çakıldığında oluşabilir.

Aynı sorgudaki farklı parametreler için geri dönüş değerleri ayarlamak için aşağıdaki örnektekine benzer bir desen kullanabilirsiniz.


CASE WHEN :static_param != 'All' THEN :static_param ELSE :dash_param END

Bu örnekte :static_param, hem görselleştirme pencere öğesinde hem de veri kümesi düzenleyicisinde 'Tümü' olarak ayarlanması gereken statik bir parametreye başvurur. parametresi :dash_param , pano tuvalinde bir filtre pencere öğesi tarafından denetlenen dinamik bir değerdir. Bu deyim, statik parametre olarak sağlanan bir değeri denetler. Hiçbiri ayarlanmazsa, görüntüleyici tarafından seçilen pano parametre değerine geri döner.

URL'ye parametreleri ekleme

Parametre ayarları URL'de depolanır, böylece kullanıcılar ön ayarlı filtreler ve parametreler de dahil olmak üzere panolarının durumunu korumak için URL'yi yer işareti olarak ekleyebilir veya aynı filtreleri ve parametreleri tutarlı bir şekilde uygulamak amacıyla başkalarıyla paylaşabilir.

Pano parametreleri ile Mustache sorgu parametreleri karşılaştırması

Pano parametreleri, adlandırılmış parametre işaretçileriyle aynı söz dizimini kullanır. Bkz. Adlandırılmış parametre işaretçileri. Kontrol panelleri Mustache şablonlama tarzı parametrelerini desteklemez.

Söz dizimi örnekleri

Parametreler için sık kullanılanlar arasında JSON dizelerinden tarih, sayı, metin, veritabanı nesnesi ve değer ekleme yer alır. Bu gibi durumlarda parametrelerin nasıl kullanılacağını gösteren örnekler için bkz. Adlandırılmış parametre söz dizimi örnekleri.

Önemli

Görüntüleyicilerin tablo veya katalog adları gibi parametre seçimleri aracılığıyla verilere erişmesini sağlamak, hassas bilgilerin yanlışlıkla açığa çıkmasına neden olabilir. Bu seçenekleri içeren bir pano yayımlıyorsanız Azure Databricks, yayımlanan panoya kimlik bilgilerini eklememenizi önerir.