Parametersyntaxis van mustache

In de verouderde SQL-editor wordt elke tekenreeks die is verpakt in dubbele accolades ({{ }}) behandeld als een queryparameter. Er wordt een widget weergegeven boven het resultatenvenster waar u de parameterwaarde instelt.

Een mustache-parameter toevoegen

1. Druk op Cmd + I. De parameter wordt ingevoegd op de cursorpositie en het dialoogvenster Parameter toevoegen wordt weergegeven.
2. Voer het trefwoord in, wijzig desgewenst de titel en selecteer een type.
3. Klik op Parameter toevoegen.
4. Stel de parameterwaarde in de widget in.
5. Klik op Wijzigingen toepassen.
6. Klik op Opslaan.

U kunt ook rechtstreeks in de query typen {{ }} en op het tandwielpictogram in de parameterwidget klikken om deze te configureren.

Als u de query opnieuw wilt uitvoeren met een andere waarde, werkt u de widget bij en klikt u op Wijzigingen toepassen.

Parameters bewerken, verwijderen en opnieuw ordenen

Bewerken: Klik op het tandwielpictogram naast de parameterwidget. Als u wilt voorkomen dat gebruikers die geen eigenaar zijn van de query de parameterwaarde wijzigen, klikt u op Alleen resultaten weergeven.

Verwijderen: Verwijder de parametermarkering uit de query. De widget wordt automatisch verwijderd.

Volgorde wijzigen: klik en sleep parameterwidgets naar de gewenste volgorde.

Widgettypen

De volgende widgettypen zijn beschikbaar:

Text

Neemt een tekenreeks als invoer. Backslash, enkele en dubbele aanhalingstekens worden automatisch geëscaped. Azure Databricks aanhalingstekens rond de waarde toevoegt.

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

Number

Neemt een getal als invoer.

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

Datum en tijd

Parameteriseert datum- en tijdstempelwaarden. Er zijn drie opties beschikbaar:

Alle datum- en tijdwaarden worden doorgegeven als letterlijke tekenreeks en moeten tussen enkele aanhalingstekens in uw query worden geplaatst:

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

Wanneer u een optie Range selecteert, maakt Azure Databricks twee parameters met behulp van .start en .end achtervoegsels:

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

Dynamische datumwaarden: Datumwidgets bevatten een blauw bliksemschichtpictogram. Klik erop om dynamische waarden te selecteren, zoals today, yesterday, this week, last week, last month of last year. Deze waarden worden automatisch bijgewerkt.

Vervolgkeuzelijst

Hiermee beperkt u de invoer tot een vooraf gedefinieerde statische lijst. Ondersteunt zowel selectie van één waarde als van meerdere waarden.

• Een waarde: Omhul de parameter met enkele aanhalingstekens in de query.

• Meerdere waarden: Schakel Meerdere waarden toestaan in de widgetinstellingen in. Gebruik de optie Aanhaling om te bepalen of waarden worden verpakt in enkele aanhalingstekens, dubbele aanhalingstekens of geen aanhalingstekens. Werk uw WHERE clausule bij om IN te gebruiken:

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

  Als er dubbele aanhalingstekens zijn geselecteerd, wordt de query omgezet in: WHERE status IN ("value1", "value2", "value3")

Waarden voor dropdownlijsten zijn tekenreeksen. Als u datums of tijdstempels wilt gebruiken, voert u deze in de indeling die uw gegevensbron nodig heeft.

Vervolgkeuzelijst op basis van query's

Vult vervolgkeuzelijsten in vanuit een opgeslagen query. Gedraagt zich als vervolgkeuzelijst, maar de opties zijn dynamisch.

1. Selecteer onder Typen in het deelvenster Instellingen de optie Vervolgkeuzelijst op basis van query's.
2. Klik op het veld Query en selecteer een opgeslagen query.

Als de query meer dan één kolom retourneert, gebruikt Azure Databricks de eerste kolom. Als de query kolommen retourneert met de naam name en value, geeft de widget de name kolom weer, maar geeft de gekoppelde value aan de query tijdens runtime door.

Voorbeeld:

SELECT user_uuid AS 'value', username AS 'name' FROM users

De waarde die tijdens runtime aan de database wordt doorgegeven, is 1001, 1002of 1003niet de weergavenaam.