Frammenti di query

Spesso è più facile duplicare il lavoro precedente e modificare piuttosto che scrivere qualcosa da zero. Ciò è particolarmente vero per le istruzioni di JOIN comuni o espressioni di CASE complesse. Man mano che l'elenco di query aumenta, può essere difficile ricordare quali query contengono l'istruzione di cui hai bisogno. È anche possibile creare un frammento di query contenente un punto di inserimento con testo segnaposto che un utente può sostituire in fase di esecuzione.

I frammenti di query sono segmenti di query che è possibile condividere e attivare usando il completamento automatico. Usare frammenti di query per:

• Istruzioni frequenti JOIN
• Clausole complesse come WITH o CASE.
• Formattazione condizionale

Ecco alcuni esempi di frammenti di codice:

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

Creare frammenti di query

È possibile creare un frammento di query dagli editor di file, notebook o SQL. Segui questi passaggi:

1. Nel nuovo editor SQL fare clic Menu kebab, quindi fare clic su Visualizza.

   Nel notebook o negli editor di file fare clic su Visualizza.

2. Clicca su Frammenti di query.

3. Fare clic su Crea frammento di query.

4. Nel campo Sostituisci, inserisci il nome del frammento. Questo nome verrà usato durante la scrittura di una query che usa il frammento di codice.

5. Immetti una descrizione (facoltativa).

6. Nel campo frammento di codice, immettere il frammento di codice.

7. Fare clic su Crea.

   

Usare un frammento di query

I frammenti di query possono essere usati in qualsiasi query SQL. È possibile accedere ai frammenti di query nell'editor SQL, nelle celle SQL del notebook, nei file SQL e nelle query del dashboard di intelligenza artificiale/BI.

Di seguito è riportato un esempio di query semplice con cui è possibile usare questi frammenti di query:

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

Per utilizzare un frammento di query con questa query, seguire i passaggi seguenti:

1. Aprire Editor SQL.

2. Digitare la query nel riquadro query dell'editor SQL.

3. Iniziare a digitare il nome del frammento di query, quindi selezionarlo dalla finestra di completamento automatico.

   Nell'editor SQL è anche possibile aprire manualmente la finestra con Control+Space e selezionare un frammento di codice.

   

4. Eseguire la query con la clausola WHERE dal frammento della query.

   

Uso dei punti di inserimento negli spezzoni di query

È possibile designare i punti di inserimento racchiudendo un ordine di tabulazioni intero con un singolo segno di dollaro e parentesi graffe ${}. Un segnaposto di testo preceduto da due punti :è facoltativo ma utile per gli utenti che non hanno familiarità con il frammento di codice. Nei frammenti di query con i punti di inserimento creati in precedenza è ${1:value} un punto di inserimento con un segnaposto ed ${1:100} è un punto di inserimento con un valore predefinito per il segnaposto di cui è possibile eseguire l'override in fase di esecuzione. Quando Databricks SQL esegue il rendering del frammento, i segni di dollaro $ e le parentesi graffe {} vengono eliminati, e la parola value o il valore predefinito di 100 viene evidenziato per la sostituzione.

Quando sono presenti più punti di inserimento, il cursore di inserimento del testo passa al primo punto di inserimento per richiedere il valore desiderato. Quando si preme Tab, il cursore salta al prossimo punto di inserimento per inserire il valore seguente. Quando si preme Tab di nuovo, il cursore passerà alla riga successiva del punto di inserimento fino a raggiungere il punto di inserimento finale.

Nota

Un punto di inserimento pari a zero ${0} è sempre l'ultimo punto nell'ordine di tabulazione.

Seguire la procedura seguente per utilizzare i frammenti di query del punto di inserimento con la query:

1. Aprire Editor SQL.

2. Digitare la query nel riquadro query dell'editor SQL.

3. Digitare le prime tre lettere del nome del frammento di query e quindi selezionare un frammento di query con il punto di inserimento senza un valore predefinito.

   Il frammento di interrogazione viene aggiunto alla query e il cursore di inserimento del testo salta al punto di inserimento.

   

4. Immettere un valore per la clausola WHERE, ad esempio 200.

5. Facoltativamente, eseguire la query con la WHERE clausola dal frammento di query.

6. Ripetere i passaggi precedenti, ma selezionare il frammento di query con il punto di inserimento usando un valore predefinito.

   

7. Ripetere i passaggi precedenti, ma selezionare il frammento di query con più punti di inserimento.

   

8. Immettere un valore per il primo punto di inserimento, poi passare al punto di inserimento successivo e immettere un valore, quindi passare al punto di inserimento finale e immettere un valore.