Aracılığıyla paylaş

Eski not defteri widgetler: ${param}

Uyarı

${param} Databricks Runtime 15.2 ve üzerinde pencere öğesi değerlerine erişim söz dizimi kullanım dışı bırakıldı. Bunun yerine geçerli Databricks pencere öğeleri söz dizimini (:param) kullanın.

Bu sayfada Databricks Runtime 15.1 ve altında çalışan not defterleri pencere öğeleri için eski ${param} söz diziminin nasıl kullanılacağı gösterilmektedir. Databricks geçerli söz dizimine geçmenizi önerir.

Databricks Runtime 15.1 ve altında pencere öğesi değerlerini kullanma

Bu bölümde, Databricks Runtime 15.1 ve altında %sql not defteri hücrelerine Databricks pencere öğeleri değerlerinin nasıl geçileceği açıklanmaktadır.

  1. Metin değerlerini belirtmek için pencere öğeleri oluşturun.

Piton

dbutils.widgets.text("database", "")
dbutils.widgets.text("table", "")
dbutils.widgets.text("filter_value", "100")

Scala

 dbutils.widgets.text("database", "")
 dbutils.widgets.text("table", "")
 dbutils.widgets.text("filter_value", "100")

R

dbutils.widgets.text("database", "")
dbutils.widgets.text("table", "")
dbutils.widgets.text("filter_value", "100")

SQL

CREATE WIDGET TEXT database DEFAULT ""
CREATE WIDGET TEXT table DEFAULT ""
CREATE WIDGET TEXT filter_value DEFAULT "100"

  1. Pencere öğesi değerlerini ${param} söz dizimini kullanarak geçirin.

    SELECT *
FROM ${database}.${table}
WHERE col == ${filter_value}
LIMIT 100

Uyarı

$ karakterden kaçmak için kullanın\$. Örneğin, dizesini $1,000ifade etmek için kullanın "\$1,000". $ SQL tanımlayıcıları için karakterden kaçılamaz.

Parametre işaretçilerine geçiş

Aşağıdaki tabloda parametreler için yaygın kullanım örnekleri, özgün Azure Databricks pencere öğesi söz dizimi (Databricks Runtime 15.2 ve üzeri için kullanım dışıdır) ve adlandırılmış parametre işaretçisi söz dizimi kullanılarak eşdeğer söz dizimi (Databricks Runtime 15.2 ve üzerinde desteklenir) gösterilmektedir.

Parametre kullanım örneği ${param} özgün pencere öğesi söz dizimi (Databricks Runtime 15.2 ve üzeri itibariyle kullanım dışıdır) :param parametre işaretçisi söz dizimi (Databricks Runtime 15.2 ve üzeri itibarıyla desteklenir)
Yalnızca belirtilen tarihten önce veri yükleme WHERE date_field < '${date_param}'
Tarih parametresinin ve süslü parantezlerin çevresine tırnak işaretleri eklemeniz gerekir.		 WHERE date_field < :date_param
Yalnızca belirtilen sayısal değerden küçük verileri yükleme WHERE price < ${max_price} WHERE price < :max_price
İki dizeyi karşılaştırma WHERE region = ${region_param} WHERE region = :region_param
Sorguda kullanılan tabloyu belirtme SELECT * FROM ${table_name} SELECT * FROM IDENTIFIER(:table)
Bir kullanıcı bu parametreyi girdiğinde, tabloyu tanımlamak için tam üç düzeyli ad alanını kullanmalıdır.
Sorguda kullanılan kataloğu, şemayı ve tabloyu bağımsız olarak belirtin SELECT * FROM ${catalog}.${schema}.${table} SELECT * FROM IDENTIFIER(:catalog \|\| '.' \|\| :schema \|\| '.' \|\| :table)
Parametreleri daha uzun, biçimlendirilmiş bir dizede şablon olarak kullanma "(${area_code}) ${phone_number}"
Parametre değerleri otomatik olarak dize olarak birleştirilir.		 format_string((%d) %d, :area_code, :phone_number)
Tam bir örnek için bkz. Birden çok parametreyi birleştirme .
Aralık oluşturma SELECT INTERVAL ${p} MINUTE SELECT CAST(:param as INTERVAL MINUTE)
Olası değerler listesine göre filtreleme SELECT * from table WHERE value IN (${list_parameter}) SELECT * FROM samples.nyctaxi.trips WHERE array_contains(TRANSFORM(SPLIT(:list_parameter, ','), s -> TRIM(s)), dropoff_zip)
  • Last updated on