Gösterge paneli parametreleriyle çalışmak

Bu sayfada, 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.

Alan filtreleri ve parametreler arasında seçim yapma

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. Alan filtreleri varsayılan olarak basamaklı davranışı destekler: Bir filtre uygulandığında, diğer filtrelerde sağlanan seçenekler uyumlu değerleri yansıtacak şekilde otomatik olarak güncelleştirilir. Daha fazla bilgi için bkz. Bir alanı veya parametreyi filtrelemeli miyim?.

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.

Sorguya parametre eklemek için:

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

2. Yeni bir parametre eklemek için Add parameter'e tıklayın.

   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 tıklayın. 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üntülenen ad: Filtre düzenleyicisinde görülen 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, String.
     • 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.

   • 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.

     Uyarı

     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

Sorgunuzu test etmek için, parametre adının altındaki metin alanına varsayılan bir değer yazın ve sorguyu çalıştırın. Bu, sonuçların önizlemesini görebilmeniz ve sorgunun beklendiği gibi çalıştığını onaylamanız için parametre değerini uygular. Sorgunun çalıştırılması varsayılan değeri de kaydeder.

Filtre pencere öğesinde parametresini kullandığınızda, pencere öğesi farklı bir varsayılan belirtmediği sürece Veri sekmesindeki varsayılan değer kullanılır. Bkz . Pano filtrelerini kullanma.

Pano yazarları, parametreli sorguların veri kümesi sekmesinde seçili varsayılan değerlerle başarıyla çalıştığını onaylamalıdır. Azure Databricks, pencere öğesi yapılandırma düzenleyicisini doldurmak için veri kümesi şemasını sorgular. Bazı durumlarda, özellikle yan tümcesini IDENTIFIER kullanan parametreli sorgularda veri kümesi sorgusu, kullanıcı çalışma zamanında bir değer seçtiğinde başarılı olsa bile varsayılan parametre değerleriyle çalışamaz.

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, ek bir ARRAY_CONTAINS denetimiyle NULL işlevini kullanır. Parametre, sorguya dizi olarak eklenebilmesi için birden çok değeri tutacak şekilde ayarlanmalıdır.

Sorgu çalıştırıldığında:

• Belirli değerler seçilirse, her satır değerlendirilir ve içindeki en az bir değerle l_quantity eşleşen tüm satırlar :parameter sonuç kümesine eklenir.
• "Tümü" seçilirse, parametresi olur NULL ve tüm satırlar döndürülür (filtreleme uygulanmaz).

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

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 simgesi. SeçBirden çok seçime izin ver.

   Uyarı

   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.

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. Koşul, OR :date_param IS NULL görüntüleyici Tümünü seçtiğinde, parametreyi null olarak ayarlayıp tüm satırları döndürdüğünde durumu yönetir.

SELECT * FROM samples.tpch.lineitem
WHERE l_shipdate BETWEEN :date_param.min AND :date_param.max
  OR :date_param IS NULL

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

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

2. Parametre adının yanındaki tıklayın. Anahtar Sözcük ve Görünen ad girin. .min veya .max sonekleri dahil etmeyin.

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 bir BETWEEN yan tümceyi .min ve .max değerleriyle kullanın ve OR :parameter IS NULL seçimleri işlemek için bir koşul ekleyin. Örneğin:

    WHERE date_col BETWEEN :date_param.min AND :date_param.max
      OR :date_param IS NULL
   

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.

Göreli tarih aralığı belirtme

Göreli tarih aralığını varsayılan parametre değeri olarak ayarlamak için, ifadeyi takvimden seçmek yerine doğrudan varsayılan değer alanına yazın. Son n günleri ifade etmek için aşağıdaki söz dizimini kullanın:

now-{n}d/d

• {n}: Bugünden itibaren geri gidilecek gün sayısı.
• /d: Sonucu günün başlangıcına yuvarlar.

Örneğin, son 30 günün varsayılan aralığını yapılandırmak için .min değerini now-30d/d olarak ayarlayın ve .max değerini now/d olarak ayarlayın.

Özel hesaplamalarda parametreleri kullanma

Doğrudan özel hesaplamalarda parametrelere :keyword sözdizimini kullanarak atıfta bulunabilirsiniz. Bkz . Özel hesaplamalarda parametreleri kullanma.

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 alan üzerine filtre uygulayan 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.

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.

Uyarı

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.

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 alış gününü Weekday veya Weekend olarak 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 aracı 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.

   

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.

   

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

Verilerin bir bölümündeki toplamaları veri kümesinin tamamına 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çirildiğinde filtreyi etkili bir şekilde atlamış olursunuz.

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'

Uyarı

Bu örnekte, "Tümü" statik seçenek olarak tanımlandığı tek değerli parametreler için özel dize değeri ('All') kullanılır. Çoklu seçim parametreleri için "Tümü" seçimlerini işlemek üzere bunun yerine OR :parameter IS NULL kullanın. Bkz. Birden çok seçime izin verme.

Üç 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.

Metin pencere öğelerinde parametreleri kullanma

@ işaretini ve ardından parametre anahtar sözcüğünü kullanarak metin pencere öğelerinde gösterge paneli parametrelerine başvurabilirsiniz. Bu, pencere öğesinin içeriğinde, başlığında ve açıklamasında geçerlidir. Görüntüleyici bir parametre değeri seçtiğinde, metin pencere öğesi geçerli seçimi yansıtacak şekilde güncelleştirilir.

Örneğin, panonuzda anahtar sözcüğü region olan bir parametre varsa, metin widget'ının başlığına veya gövdesine Sales data for @region yazabilirsiniz; bu, seçilen değerle görüntülenir.

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. "Bir filtre (alan/parametre) ekle seçeneğine tıklayın."
2. Yapılandırma panelinde, Parametreler 'ın yanındaki "alan ekle" simgesine 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. Pano tuvalinde bir filtre bileşeni tarafından denetlenen parametre :dash_param, dinamik bir değerdir. Bu ifade, statik parametre olarak sağlanan bir değeri kontrol eder. 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 ve kullanıcıların önceden ayarlanmış filtreler ve parametreler de dahil olmak üzere panolarının durumunu korumak için yer işareti eklemesine veya aynı filtreleri ve parametreleri tutarlı bir şekilde uygulamak üzere başkalarıyla paylaşmasına olanak tanır.

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.

Pano parametreleri ile not defteri pencere öğesi parametreleri karşılaştırması

AI/BI pano parametreleri ve not defteri pencere öğesi parametreleri farklı amaçlara hizmet eder ve birbirinin yerine getirilemez:

• Pano parametreleri (bu sayfa): Çalışma zamanında pano veri kümelerindeki verileri filtrelemek için kullanılır. Bunlar bir panonun Veri sekmesinde tanımlanır ve tuvaldeki filtre pencere öğeleri aracılığıyla izleyicilere sunulur.
• Not defteri pencere öğesi parametreleri: ile dbutils.widgetsyapılandırılan not defteri hücrelerine etkileşimli olarak değer geçirmek için kullanılır. Bunlar, yalnızca not defterleriyle sınırlıdır ve Yapay Zeka/İş Zekası panolarında kullanılamaz.

Not defteri destekli verileri sorgulayan panolar oluşturuyorsanız, pano parametrelerinin filtrelemeyi not defteri yürütme düzeyinde değil veri kümesi sorgu düzeyinde denetlediğini unutmayın.

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.