Mustache paraméter szintaxisa

Fontos

A bajuszparaméter szintaxisa csak az örökölt SQL-szerkesztőben támogatott. A Databricks névvel ellátott paraméterjelölőket javasol az új lekérdezésekhez. Ha mustache szintaxissal másol egy lekérdezést egy jegyzetfüzetbe, az AI/BI dashboard adatkészlet-szerkesztőjébe vagy a Genie térbe, mielőtt futtathatja, át kell alakítania őket névvel ellátott paraméterjelölőkké.

Az örökölt SQL-szerkesztőben a kettős kapcsos zárójelekbe ({{ }}) csomagolt sztringek lekérdezési paraméterként lesznek kezelve. Megjelenik egy widget az eredménypanel felett, ahol beállítja a paraméter értékét.

Bajuszparaméter hozzáadása

  1. Nyomja le a Cmd + Ibillentyűt. A paraméter be lesz szúrva a kurzor pozíciójába, és megjelenik a Paraméter hozzáadása párbeszédpanel.
  2. Adja meg a kulcsszót, tetszés szerint módosítsa a címet, és válasszon egy típust.
  3. Kattintson a Paraméter hozzáadása elemre.
  4. Adja meg a paraméter értékét a widgetben.
  5. Kattintson a Módosítások alkalmazása gombra.
  6. Kattintson a Mentés lehetőségre.

Másik lehetőségként írja be {{ }} közvetlenül a lekérdezést, és a paraméter widgetben kattintson a fogaskerék ikonra a konfigurálásához.

Ha egy másik értékkel szeretné újra futtatni a lekérdezést, frissítse a widgetet, és kattintson a Módosítások alkalmazása gombra.

Paraméterek szerkesztése, eltávolítása és átrendezés

Szerkesztés: Kattintson a fogaskerék ikonra a paraméter widget mellett. Ha meg szeretné akadályozni, hogy a lekérdezést nem birtokba vevő felhasználók módosítják a paraméter értékét, kattintson a Csak eredmények megjelenítése gombra.

Eltávolítás: Törölje a paraméterjelölőt a lekérdezésből. A widget automatikusan törlődik.

Átrendezés: Kattintson és húzza a paraméter widgeteket a kívánt sorrendbe.

Widgettípusok

A következő vezérlőtípusok érhetők el:

Szöveg

Bemenetként egy karakterláncot vesz fel. A fordított perjelek, az egy- és a dupla idézőjelek automatikusan feloldódnak. Azure Databricks idézőjeleket ad hozzá az értékhez.

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

Szám

Bemenetként számokat vesz fel.

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

Dátum és idő

Paraméterezi a dátum- és időbélyeg-értékeket. Három lehetőség érhető el:

Típus Precizitás
Dátum Nap
Dátum és idő Minute
Dátum és idő (másodpercekkel) Second

A rendszer minden dátum- és időértéket sztringkonstansként ad át, és a lekérdezésben egyetlen idézőjelbe kell burkolni:

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

Ha kiválaszt egy Range beállítást, Azure Databricks két paramétert hoz létre .start és .end utótagokkal:

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

Megjegyzés:

A Dátumtartomány widget csak a DATE-típusú oszlopok esetén ad helyes eredményeket vissza. Időbélyegoszlopok esetén használjon dátum- és időtartomány-vezérlőt.

Dinamikus dátumértékek: A dátum widgetek kék villámgyors ikont tartalmaznak. Kattintson rá az olyan dinamikus értékek kiválasztásához, mint todaya , yesterday, this week, last week, last monthvagy last year. Ezek az értékek automatikusan frissülnek.

Fontos

A dinamikus dátumértékek nem kompatibilisek az ütemezett lekérdezésekkel.

Előre definiált statikus listára korlátozza a bemenetet. Támogatja az egy- és a többértékű kijelölést is.

  • Egyetlen érték: A paraméter körbefuttatása egy idézőjelben a lekérdezésben.

  • Többértékű: Több érték engedélyezése a widget beállításaiban. Az Idézet beállítással szabályozhatja, hogy az értékek egyetlen idézőjelbe, dupla idézőjelbe vagy egyikbe sem vannak-e csomagolva. Frissítse a(z) WHERE záradékot úgy, hogy a(z) IN-t használja.

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

    Ha kettős idézőjelek vannak kiválasztva, a lekérdezés a következőre lesz feloldva: WHERE status IN ("value1", "value2", "value3").

A legördülő lista értékei sztringek. Dátumok vagy időbélyegek használatához adja meg őket az adatforrás által igényelt formátumban.

Lekérdezésalapú legördülő lista

Mentett lekérdezésből tölti ki a legördülő lista választási lehetőségeit. Úgy viselkedik, mint a legördülő lista, de a beállítások dinamikusak.

  1. A Beállítások panel Típus területén válassza a Lekérdezésalapú legördülő lista lehetőséget.
  2. Kattintson a Lekérdezés mezőre, és válasszon ki egy mentett lekérdezést.

Ha a lekérdezés egynél több oszlopot ad vissza, Azure Databricks az első oszlopot használja. Ha a lekérdezés nevesített namevalueoszlopokat ad vissza, a widget megjeleníti az name oszlopot, de futásidőben átadja a lekérdezéshez társított value oszlopot.

Példa:

SELECT user_uuid AS 'value', username AS 'name' FROM users
value név
1001 John Smith
1002 Jane Doe
1003 Bobby Tables

A futtatókörnyezetben az adatbázisnak átadott érték 1001, 1002 vagy 1003, nem a megjelenített név.

Megjegyzés:

A teljesítmény csökken, ha a forrás lekérdezés nagy számú rekordot ad vissza.

  • Last updated on