Queryfragmenten

Het is vaak gemakkelijker om eerdere werkzaamheden te dupliceren en te wijzigen dan om iets helemaal opnieuw te schrijven. Dit geldt met name voor algemene JOIN-instructies of complexe CASE expressies. Naarmate uw list van query's groeit, kan het lastig zijn om te onthouden welke query's de instructie bevatten die u nodig hebt. U kunt ook een queryfragment maken dat een invoegpositie bevat met tijdelijke aanduidingstekst die een gebruiker tijdens de uitvoering kan vervangen.

Queryfragmenten zijn segmenten van query's die u kunt delen en activeren met behulp van automatisch aanvullen. Queryfragmenten gebruiken voor:

• Frequente JOIN instructies
• Gecompliceerde clausules zoals WITH of CASE.
• Voorwaardelijke opmaak

Hier volgen voorbeelden van fragmenten:

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

Queryfragmenten maken

Gebruik de volgende stappen om fragmenten te maken met behulp van deze voorbeelden van fragmenten:

1. Klik op uw gebruikersnaam in de bovenste balk van de werkruimte en selectInstellingen in het dropdownmenu.

2. Klik op het tabblad Developer.

3. Klik naast SQL-queryfragmenten op klik op beheren.

4. Klik op Maak queryfragment.

5. Voer in het veld Vervangen de naam van het fragment in. U gebruikt deze naam bij het schrijven van een query waarin het fragment wordt gebruikt.

6. Voer desgewenst een beschrijving in.

7. Voer in het veld Fragment het fragment in.

8. Klik op maken.

   

Een queryfragment gebruiken in een query

Hier volgt een voorbeeld van een eenvoudige query waarmee u deze queryfragmenten kunt gebruiken:

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

Gebruik de volgende stappen om een queryfragment met deze query te gebruiken:

1. Open SQL Editor-.

2. Typ uw query in het queryvenster van de SQL-editor.

3. Typ de eerste 3 letters van de naam van het fragment en select vervolgens een fragment uit de windowvoor automatisch aanvullen. U kunt het window ook handmatig openen door op Option + Space te drukken en select een fragment.

   

4. Voer de query uit met de WHERE component uit het queryfragment.

   

Werken met invoegpunten in queryfragmenten

U wijst invoegpunten aan door een gehele tabvolgorde te verpakken met één dollarteken en accolades ${}. Een tijdelijke aanduiding voor tekst voorafgegaan door een dubbelenpunt :is optioneel, maar handig voor gebruikers die uw fragment niet kennen. In de queryfragmenten met invoegpunten die u eerder hebt gemaakt, is ${1:value} een invoegpunt met tijdelijke aanduiding en ${1:100} een invoegpositie met een standaardwaarde voor de tijdelijke aanduiding die u tijdens runtime kunt overschrijven. Wanneer Databricks SQL het codefragment weergeeft, worden het dollarteken $ en accolades {} verwijderd en wordt het woord value of de standaardwaarde van 100 gemarkeerd voor vervanging.

Wanneer er meerdere invoegpunten zijn, springt de tekst invoeg carat naar de eerste invoegpositie om naar de gewenste waarde te vragen. Wanneer u op Tabdrukt, springt de cursor naar het volgende invoegpunt voor de volgende waarde. Wanneer u nogmaals op Tab drukt, springt de cursor naar het volgende invoegpunt totdat het het laatste invoegpunt bereikt.

Notitie

Een invoegpositie van nul ${0} is altijd het laatste punt in de tabvolgorde.

Gebruik de volgende stappen om de fragmenten van de invoegpositiequery te gebruiken met de query:

1. Open SQL Editor-.

2. Typ uw query in het queryvenster van de SQL-editor.

3. Typ de eerste drie letters van de naam van het queryfragment en select vervolgens een queryfragment met de invoegpositie zonder standaardwaarde.

   Het queryfragment wordt toegevoegd aan de query en de tekstinvoegingscarat springt naar de invoegpositie.

   

4. Voer een waarde in voor de WHERE-component, zoals 200.

5. Voer desgewenst de query uit met de WHERE component uit het queryfragment.

6. Herhaal de vorige stappen, maar select het queryfragment met de invoegpositie met behulp van een standaardwaarde.

   

7. Herhaal de vorige stappen, maar select het queryfragment met meerdere invoegpunten.

   

8. Voer een waarde in voor de eerste invoegpositie, ga met de tab naar de volgende invoegpositie en voer een waarde in en ga vervolgens met de tab naar de laatste invoegpositie en voer een waarde in.