Aracılığıyla paylaş

Pano parametreleri nelerdir?

  • Makale

Pano parametreleri panoları etkileşimli hale getirmenin bir yoludur ve görüntüleyicilerin çalışma zamanında veri kümesi sorgularına belirli değerleri girmek için tek değerli seçicileri ve tarih seçicileri kullanmasını sağlar. Örneğin parametreler, verileri sql sorgusunda toplanmadan önce tarihler ve ürün kategorileri gibi ölçütlere göre filtreleyerek daha verimli sorgulama ve hassas analiz olanağı sağlayabilir.

Parametreler veri kümelerine eklenir ve pano yazarı veya düzenleyicisi tarafından pano tuvalinde bir veya daha fazla pencere öğesine bağlanır. Pano görüntüleyicileri, çalışma zamanında filtre pencere öğelerindeki değerleri seçerek pano verileriyle etkileşim kurar. Bu, ilişkili sorguları yeniden çalıştırır ve filtrelenen veriler üzerinde oluşturulan görselleştirmeleri sunar.

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

Sorguya parametre ekleme

Pano veri kümesine parametre eklemek için taslak panoda en azından Düzenleyebilir izinlerine sahip olmanız gerekir. Veri sekmesindeki veri kümesi sorgularına doğrudan parametre 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. Yeni parametre eklemek için Parametre ekle'ye 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 öğ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.
  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

Parametrenizin varsayılan değerini, parametre adının altındaki metin alanına yazarak ayarlayabilirsiniz. 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 varsayılan değer kullanılır.

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ı, uygun parametre değerlerinin istenen listesiyle alanı kullanacak şekilde ayarlanmalıdır.
    • Parametreler 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.

Sorgu tabanlı parametre ve görselleştirme eklemeyi gösteren adım adım öğretici için bkz . Sorgu tabanlı parametreleri kullanma.

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, veri kümesi güncelleştirildiğinde 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)

Filtre türleri

Tek Değer ve Tarih Seçici filtreleri, ayar parametrelerini destekler. Tarih Seçici filtresiyle sorgu tabanlı parametreler ayarlanırken, temel sorgunun sonuçlarında görünen tarihler siyah olarak gösterilir. Sorgu sonuçlarında görünmeyen tarihler gridir. Kullanıcılar, temel alınan sorguya dahil edilmeseler bile gri tarihleri seçebilir.

Sorgu parametresini kaldırma

Parametreyi kaldırmak için sorgunuzdan silin.

Panoda parametreleri gösterme

Pano tuvalinize filtre eklemek, izleyicilerin parametre değerlerini seçip değiştirmesine olanak tanır, böylece verileri etkileşimli olarak inceleyebilir ve analiz edebilir. 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ınFiltre Simgesi.
  2. Yapılandırma panelinde Parametreler'in yanındaki öğesine tıklayınalan ekle simgesi.
  3. Görüntüleyicinin bu pencere öğesiyle kullanmasını istediğiniz parametre adına tıklayın.

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ı filtre ve parametrelerin tutarlı bir şekilde uygulanması için bunu başkalarıyla paylaşmasına olanak tanır.

Parametre söz dizimi örnekleri

Aşağıdaki örneklerde parametreler için bazı yaygın kullanım örnekleri gösterilmiştir.

Tarih ekleme

Aşağıdaki örnek, sorgu sonuçlarını belirli bir tarihten sonraki kayıtlara sınırlayan bir Date parametresini içerir.


SELECT
  o_orderdate AS Date,
  o_orderpriority AS Priority,
  sum(o_totalprice) AS `Total Price`
FROM
  samples.tpch.orders
WHERE
  o_orderdate > :date_param
GROUP BY
  1,
  2

Sayı ekleme

Aşağıdaki örnek, sonuçları alanın sağlanan parametre değerinden o_total_price büyük olduğu kayıtlara sınırlayan bir Sayısal parametre içerir.


SELECT
  o_orderdate AS Date,
  o_orderpriority AS Priority,
  o_totalprice AS Price
FROM
  samples.tpch.orders
WHERE
  o_totalprice > :num_param

Alan adı ekleme

Aşağıdaki örnekte, field_param çalışma zamanında sorgu için eşik değeri sağlamak üzere işleviyle birlikte IDENTIFIER kullanılır. Parametre değeri, sorguda kullanılan tablodan bir sütun adı olmalıdır.


SELECT
  *
FROM
  samples.tpch.orders
WHERE
  IDENTIFIER(:field_param) < 10000

Veritabanı nesneleri ekleme

Aşağıdaki örnek üç parametre oluşturur: catalog, schemave table. Pano görüntüleyicileri parametre değerlerini seçmek için tuvaldeki filtre pencere öğelerini kullanabilir.


SELECT
  *
FROM
  IDENTIFIER(:catalog || '.' || :schema || '.' || :table)

Bkz. IDENTIFIER yan tümcesi.

Önemli

Pano görüntüleyicilerinin 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.

Birden çok parametreyi birleştirme

Parametreleri diğer SQL işlevlerine ekleyebilirsiniz. Bu örnek, görüntüleyicinin bir çalışan unvanı ve bir numara kimliği seçmesine olanak tanır. Sorgu, iki dizeyi format_string birleştirmek ve eşleşen satırları filtrelemek için işlevini kullanır. Bkz. format_string işlevi.


SELECT
  o_orderkey,
  o_clerk
FROM
  samples.tpch.orders
WHERE
  o_clerk LIKE format_string('%s%s', :title, :emp_number)

Pano parametreleri ile Databricks SQL 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. Panolar Databricks SQL stili parametrelerini desteklemez.