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 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 verklaringen
• 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

U kunt een queryfragment maken vanuit de SQL-, notebook- of bestandseditors. Volg deze stappen:

1. Klik in de nieuwe SQL-editor op het kebabmenu, klik vervolgens op Bekijk.

   Klik in de notitieblok- of bestandseditors op Weergeven.

2. Klik op Queryfragmenten.

3. Klik op Maak queryfragment.

4. Voer in het veld Vervangen de naam van het fragment in. U gebruikt deze naam bij het schrijven van een query die gebruikmaakt van het fragment.

5. (Optioneel) Voer een beschrijving in.

6. Voer in het veld Fragment het fragment in.

7. Klik op maken.

   

Een queryfragment gebruiken

Queryfragmenten kunnen in elke SQL-query worden gebruikt. U kunt queryfragmenten openen in de SQL-editor, SQL-cellen, SQL-bestanden en AI/BI-dashboardquery's.

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. Begin de naam van het queryfragment te typen en selecteer het in het venster voor automatisch aanvullen.

   In de SQL-editor kunt u het venster ook handmatig openen en Control+Space een fragment selecteren.

   

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, ${1:value} is een invoegpunt met een tijdelijke aanduiding en ${1:100} een invoegpositie met een standaardwaarde voor de tijdelijke aanduiding die u tijdens runtime kunt overschrijven. Wanneer Databricks SQL het fragment 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 cursor naar het eerste invoegpunt om de gewenste waarde in te voeren. Wanneer u op Tab drukt, springt de caret naar de volgende invoegpositie voor de volgende waarde. Wanneer u nogmaals drukt Tab , springt de caret 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 drie 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 tekstcursor 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 naar de laatste invoegpositie en voer een waarde in.