Fragmenty zapytań
Często łatwiej jest duplikować wcześniejsze prace i modyfikować niż pisać coś od podstaw. Dotyczy to szczególnie typowych JOIN
instrukcji lub wyrażeń złożonych CASE
. Wraz ze wzrostem listy zapytań może być trudno zapamiętać, które zapytania zawierają potrzebną instrukcję. Możesz również utworzyć fragment zapytania zawierający punkt wstawiania z tekstem zastępczym, który użytkownik może zastąpić w czasie wykonywania.
Fragmenty zapytań to segmenty zapytań, które można udostępniać i wyzwalać przy użyciu autouzupełnienia. Użyj fragmentów zapytania dla:
- Częste
JOIN
instrukcje - Skomplikowane klauzule, takie jak
WITH
lubCASE
. - Formatowanie warunkowe
Oto przykłady fragmentów kodu:
--Simple snippet
WHERE fare_amount > 100
--Snippet with an insertion point for a value to be provided at runtime
WHERE fare_amount > ${1:value}
--Snippet with an insertion point for a value to be provided at runtime and containing a default value
WHERE fare_amount > ${1:100}
--Snippet with multiple insertion points
WHERE fare_amount > ${2:min_value} AND fare_amount < ${1:max_value} AND trip_distance < ${0:max_distance}
Tworzenie fragmentów zapytania
Wykonaj następujące kroki, aby utworzyć fragmenty kodu przy użyciu tych przykładów fragmentów kodu:
Kliknij swoją nazwę użytkownika na górnym pasku obszaru roboczego i wybierz pozycję Ustawienia z listy rozwijanej.
Kliknij kartę Deweloper .
Obok pozycji Fragmenty zapytań SQL kliknij pozycję Zarządzaj.
Kliknij pozycję Utwórz fragment zapytania.
W polu Zamień wprowadź nazwę fragmentu kodu. Użyjesz tej nazwy podczas pisania zapytania, w którym użyto fragmentu kodu.
Opcjonalnie wprowadź opis.
W polu Fragment kodu wprowadź fragment kodu.
Kliknij pozycję Utwórz.
Używanie fragmentu kodu zapytania w zapytaniu
Oto przykład prostego zapytania, za pomocą którego można użyć tych fragmentów zapytania:
--Simple query
SELECT * FROM samples.nyctaxi.trips
Wykonaj następujące kroki, aby użyć fragmentu kodu zapytania z tym zapytaniem:
Otwórz edytor SQL.
Wpisz zapytanie w okienku zapytania edytora SQL.
Wpisz pierwsze 3 litery nazwy fragmentu kodu, a następnie wybierz fragment kodu w oknie autouzupełniania. Możesz również ręcznie otworzyć okno, naciskając
Option
+Space
i wybierając fragment kodu.Wykonaj zapytanie z klauzulą
WHERE
z fragmentu kodu zapytania.
Praca z punktami wstawiania w fragmentach zapytania
Punkty wstawiania wyznacza się przez zawijanie kolejności tabulacji liczb całkowitych za pomocą znaku pojedynczego dolara i nawiasów klamrowych ${}
. Symbol zastępczy tekstu poprzedzony dwukropkiem :
jest opcjonalny, ale przydatny dla użytkowników nieznanych fragmentu kodu. W fragmentach kodu zapytania z utworzonymi wcześniej ${1:value}
punktami wstawiania jest punktem wstawiania z symbolem zastępczym i ${1:100}
jest punktem wstawiania z wartością domyślną symbolu zastępczego, który można zastąpić w czasie wykonywania. Gdy usługa Databricks SQL renderuje fragment kodu, znak $
dolara i nawiasy klamrowe {}
zostaną usunięte, a wyraz value
lub wartość domyślna 100
zostanie wyróżniona do zastąpienia.
Gdy istnieje wiele punktów wstawiania, karat wstawiania tekstu przechodzi do pierwszego punktu wstawiania, aby wyświetlić monit o żądaną wartość. Po naciśnięciu klawisza Tab
karat przechodzi do następnego punktu wstawiania dla następnej wartości. Po ponownym naciśnięciu Tab
karat przejdzie do następnej linii punktu wstawiania do momentu osiągnięcia końcowego punktu wstawiania.
Uwaga
Punkt wstawiania zera ${0}
jest zawsze ostatnim punktem w kolejności tabulacji.
Wykonaj następujące kroki, aby użyć fragmentów zapytania punktu wstawiania z zapytaniem:
Otwórz edytor SQL.
Wpisz zapytanie w okienku zapytania edytora SQL.
Wpisz pierwsze 3 litery nazwy fragmentu zapytania, a następnie wybierz fragment zapytania z punktem wstawiania bez wartości domyślnej.
Fragment zapytania jest dodawany do zapytania, a karat wstawiania tekstu przechodzi do punktu wstawiania.
Wprowadź wartość klauzuli
WHERE
, na przykład200
.Opcjonalnie wykonaj zapytanie z klauzulą
WHERE
z fragmentu kodu zapytania.Powtórz poprzednie kroki, ale wybierz fragment zapytania z punktem wstawiania przy użyciu wartości domyślnej.
Powtórz poprzednie kroki, ale wybierz fragment zapytania z wieloma punktami wstawiania.
Wprowadź wartość pierwszego punktu wstawiania, kartę do następnego punktu wstawiania i wprowadź wartość, a następnie kartę do końcowego punktu wstawiania i wprowadź wartość.