Mustache parametresi sözdizimi

Önemli

"Mustache" parametre söz dizimi yalnızca eski SQL düzenleyicisinde desteklenir. Databricks, yeni sorgular için adlandırılmış parametre işaretleyicilerinin kullanılmasını önerir. Mustache sözdizimini kullanarak bir notebook'a, AI/BI pano veri kümesi düzenleyicisine veya Genie alanına bir sorgu kopyalarsanız, çalıştırmadan önce bunu adlandırılmış parametre işaretçilerine dönüştürmeniz gerekir.

Eski SQL düzenleyicisinde, çift küme ayracı ({{ }}) içine sarmalanan tüm dizeler sorgu parametresi olarak değerlendirilir. Parametre değerini ayarladığınız sonuçlar bölmesinin üzerinde bir pencere öğesi görüntülenir.

Bıyık parametresi ekleme

  1. Cmd + I tuşuna basın. Parametre imleç konumuna eklenir ve Parametre Ekle iletişim kutusu görüntülenir.
  2. Anahtar Sözcüğü girin, isteğe bağlı olarak Başlığı değiştirin ve bir Tür seçin.
  3. Parametre Ekle'ye tıklayın.
  4. Widget'ta parametre değerini ayarlayın.
  5. Değişiklikleri Uygula'ya tıklayın.
  6. Kaydet'e tıklayın.

Alternatif olarak, doğrudan sorguya yazın {{ }} ve yapılandırmak için parametre pencere öğesindeki dişli simgesine tıklayın.

Sorguyu farklı bir değerle yeniden çalıştırmak için pencere öğesini güncelleştirin ve Değişiklikleri Uygula'ya tıklayın.

Parametreleri düzenleme, kaldırma ve yeniden sıralama

Düzenle: Parametre pencere öğesinin yanındaki dişli simgesine tıklayın. Sorgunun sahibi olmayan kullanıcıların parametre değerini değiştirmesini önlemek için Yalnızca Sonuçları Göster'e tıklayın.

Kaldır: Parametre işaretçisini sorgudan silin. Pencere öğesi otomatik olarak kaldırılır.

Yeniden sırala: Parametre pencere öğelerini tıklayıp istediğiniz sıraya sürükleyin.

Pencere öğesi türleri

Aşağıdaki pencere öğesi türleri kullanılabilir:

Metin

Giriş olarak bir metin alır. Ters eğik çizgi, tek ve çift tırnak işaretleri otomatik olarak kaçıştır. Azure Databricks değerin etrafına tırnak işaretleri ekler.

SELECT * FROM samples.tpch.customer WHERE c_name = {{ name_param }}

Sayı

Girdi olarak bir sayı alır.

SELECT * FROM users WHERE age = {{ number_param }}

Tarih ve Saat

Tarih ve zaman damgası değerlerini parametreleştirir. Üç seçenek vardır:

Türü Hassasiyet
Tarih Gün
Tarih ve Saat Dakika
Tarih ve Saat (saniye ile) Second

Tüm tarih ve saat değerleri string sabitleri olarak geçirilir ve sorgunuzda tek tırnak içine alınmalıdır.

SELECT * FROM usage_logs WHERE date = '{{ date_param }}'

Range seçeneğini belirlediğinizde Azure Databricks .start ve .end soneklerini kullanarak iki parametre oluşturur:

SELECT * FROM usage_logs
WHERE modified_time > '{{ date_range.start }}'
AND modified_time < '{{ date_range.end }}'

Uyarı

Tarih Aralığı pencere öğesi yalnızca DATE türü sütunlar için doğru sonuçları döndürür. Zaman damgası sütunları için Tarih ve Saat Aralığı widget'ı kullanın.

Dinamik tarih değerleri: Tarih pencere öğeleri mavi şimşek simgesi içerir. today, yesterday, this week, last week, last month veya last year gibi dinamik değerleri seçmek için buna tıklayın. Bu değerler otomatik olarak güncelleştirilir.

Önemli

Dinamik tarih değerleri zamanlanmış sorgularla uyumlu değildir.

Girişi önceden tanımlanmış bir statik listeyle kısıtlar. Hem tek değerli hem de çok değerli seçimi destekler.

  • Tek değer: Parametreyi sorguda tek tırnak içerisine alın.

  • Çoklu değer: Pencere öğesi ayarlarında Birden çok değere izin ver'i etkinleştirin. Değerlerin tek tırnak içinde mi, çift tırnak içinde mi yoksa hiç mi kullanılacağını denetlemek için Tırnak seçeneğini kullanın. WHERE yan tümcenizi IN kullanarak güncelleyin:

    SELECT * FROM orders WHERE status IN ( {{ status_param }} )

    Çift tırnak işaretleri seçili durumdayken sorgu şu şekilde çözümlenir: WHERE status IN ("value1", "value2", "value3").

Açılan Liste değerleri dizelerdir. Tarihleri veya zaman damgalarını kullanmak için, bunları veri kaynağınızın gerektirdiği biçimde girin.

Sorgu Tabanlı Açılan Liste

Kaydedilmiş bir sorgudan açılır menü seçeneklerini doldurur. Açılan Liste gibi davranır ancak seçenekler dinamiktir.

  1. Ayarlar panelindeki Tür altında Sorgu Tabanlı Açılan liste'yi seçin.
  2. Sorgu alanına tıklayın ve kaydedilmiş bir sorgu seçin.

Sorgu birden fazla sütun döndürürse, Azure Databricks ilk sütunu kullanır. Sorgu, name ve value adlı sütunları döndürürse, pencere öğesi name sütununu görüntüler ancak ilişkili value öğesini çalışma zamanında sorguya iletir.

Örnek:

SELECT user_uuid AS 'value', username AS 'name' FROM users
değer isim
1001 John Smith
1002 Jane Doe
1003 Bobby Tables

Çalışma zamanında veritabanına geçirilen değer, görünen ad değil,1001, 1002 veya 1003'dir.

Uyarı

Kaynak sorgu çok sayıda kayıt döndürürse performans düşer.

  • Last updated on