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 lijst met 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 aanduidingen voor tekst die een gebruiker tijdens runtime 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 componenten 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 selecteer Instellingen in de vervolgkeuzelijst.

2. Klik op het tabblad Ontwikkelaars .

3. Klik naast SQL-queryfragmenten op Beheren.

4. Klik op Queryfragment maken.

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 Create.

   

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 selecteer vervolgens een fragment in het venster voor automatisch aanvullen. U kunt het venster ook handmatig openen door op een fragment te drukken Option + Space en te selecteren.

   

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

   

Werken met invoegpunten in queryfragmenten

U wijst invoegpunten aan door een geheel getal in een tabvolgorde te verpakken met één dollarteken en accolades ${}. Een tijdelijke aanduiding voor tekst die wordt voorafgegaan door een dubbele punt :is optioneel, maar handig voor gebruikers die niet bekend zijn met uw fragment. In de queryfragmenten met invoegpunten die u eerder hebt gemaakt, ${1:value} is 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 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 drukt Tab, springt de carat naar de volgende invoegpositie voor de volgende waarde. Wanneer u nogmaals drukt Tab , springt de carat naar de volgende invoegpositielijn totdat deze de laatste invoegpositie 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 3 letters van de naam van het queryfragment en selecteer 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 selecteer het queryfragment met de invoegpositie met behulp van een standaardwaarde.

   

7. Herhaal de vorige stappen, maar selecteer 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.