Abfrageausschnitte

Es ist oft einfacher, vorherige Arbeit zu duplizieren und zu ändern, als etwas von Grund auf neu zu schreiben. Dies gilt insbesondere für allgemeine JOIN Anweisungen oder komplexe CASE Ausdrücke. Wenn Ihre Liste der Abfragen wächst, kann es schwierig sein, sich daran zu erinnern, welche Abfragen die benötigte Anweisung enthalten. Sie können auch einen Abfrageausschnitt erstellen, der einen Einfügepunkt mit Platzhaltertext enthält, den ein Benutzer zur Laufzeit ersetzen kann.

Abfrage-Snippets sind Segmente von Abfragen, die Sie teilen und mit Autocomplete triggern können. Verwenden von Abfrageausschnitten für:

• Häufige JOIN-Anweisungen
• Komplizierte Klauseln wie WITH oder CASE.
• Bedingte Formatierung

Hier sind Beispiele für Codeausschnitte:

--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}

Erstellen von Abfrageausschnitten

Sie können einen Abfrageausschnitt aus den SQL-, Notizbuch- oder Datei-Editoren erstellen. Folgen Sie diesen Schritten:

1. Klicken Sie im neuen SQL-Editor auf das Kebab-Menü, und klicken Sie dann auf "Ansicht".

   Klicken Sie in den Notizbuch- oder Datei-Editoren auf "Ansicht".

2. Klicken Sie auf Abfrageausschnitte.

3. Klicken Sie auf "Abfrageausschnitt erstellen".

4. Geben Sie im Feld "Ersetzen " den Codeausschnittnamen ein. Sie verwenden diesen Namen beim Schreiben einer Abfrage, die den Codeausschnitt verwendet.

5. (Optional) Geben Sie eine Beschreibung ein.

6. Geben Sie im Feld "Codeausschnitt " den Codeausschnitt ein.

7. Klicken Sie auf "Erstellen".

   

Verwenden eines Query-Snippets

Abfrageausschnitte können in beliebigen SQL-Abfragen verwendet werden. Sie können im SQL-Editor, Notizbuch-SQL-Zellen, SQL-Dateien und AI/BI-Dashboardabfragen auf Abfrageausschnitte zugreifen.

Hier ist ein Beispiel für eine einfache Abfrage, mit der Sie diese Abfrageausschnitte verwenden können:

--Simple query
SELECT * FROM samples.nyctaxi.trips

Führen Sie die folgenden Schritte aus, um einen Abfrageausschnitt mit dieser Abfrage zu verwenden:

1. Öffnen Sie den SQL-Editor.

2. Geben Sie Ihre Abfrage im SQL-Editor-Abfragebereich ein.

3. Beginnen Sie mit der Eingabe des Namens ihres Abfrageausschnitts, und wählen Sie ihn im Fenster "AutoVervollständigen" aus.

   Im SQL-Editor können Sie das Fenster auch manuell öffnen Control+Space und einen Codeausschnitt auswählen.

   

4. Führen Sie die Abfrage mit der WHERE Klausel aus dem Abfrageausschnitt aus.

   

Arbeiten mit Einfügemarken in Abfrageausschnitten

Sie können Einfügepunkte festlegen, indem Sie eine ganzzahlige Aktivierreihenfolge mit einem einzelnen Dollarzeichen und geschweiften Klammern (${}) umschließen. Ein Textplatzhalter vor einem Doppelpunkt :ist optional, aber nützlich für Benutzer, die mit Ihrem Codeausschnitt nicht vertraut sind. In den von Ihnen erstellten Abfrageausschnitten ist ${1:value} ein Einfügepunkt mit einem Platzhalter, und ${1:100} ist ein Einfügepunkt mit einem Standardwert für den Platzhalter, den Sie zur Laufzeit ändern können. Wenn Databricks SQL den Codeausschnitt rendert, werden das Dollarzeichen $ und geschweifte Klammern {} entfernt, und das Wort value oder der Standardwert 100 ist zum Ersetzen hervorgehoben.

Wenn mehrere Einfügemarken vorhanden sind, springt der Texteinfügemarker zur ersten Einfügemarke, um nach dem gewünschten Wert zu fragen. Wenn Sie Tab drücken, springt der Marker zur nächsten Einfügemarke für den nächsten Wert. Wenn Sie Tab erneut drücken, springt der Marker zur nächsten Einfügemarke, bis er die letzte Eingabemarke erreicht.

Hinweis

Eine Einfügemarke von Null ${0} ist immer der letzte Punkt in der Aktivierreihenfolge.

Führen Sie die folgenden Schritte aus, um die Einfügemarken-Abfrageausschnitte mit der Abfrage zu verwenden:

1. Öffnen Sie den SQL-Editor.

2. Geben Sie Ihre Abfrage im SQL-Editor-Abfragebereich ein.

3. Geben Sie die ersten drei Buchstaben des Namens Ihres Abfragefragments ein und wählen Sie dann ein Abfragefragment ohne Standardwert am Einfügepunkt aus.

   Der Abfrageausschnitt wird der Abfrage hinzugefügt, und der Texteinfügemarker springt zur Einfügemarke.

   

4. Geben Sie einen Wert für die WHERE-Klausel ein, z. B. 200.

5. Führen Sie optional die Abfrage mit der WHERE Klausel aus dem Abfrageausschnitt aus.

6. Wiederholen Sie die vorherigen Schritte, aber wählen Sie den Abfrageausschnitt mit der Einfügemarke mit einem Standardwert aus.

   

7. Wiederholen Sie die vorherigen Schritte, aber wählen Sie den Abfrageausschnitt mit mehreren Einfügepunkten aus.

   

8. Geben Sie einen Wert für die erste Einfügemarke ein, wechseln Sie zur nächsten Einfügemarke, und geben Sie einen Wert ein, und wechseln Sie dann zur endgültigen Einfügemarke, und geben Sie einen Wert ein.