Extraits de query

Il est souvent plus facile de dupliquer un travail antérieur et de le modifier que d'écrire quelque chose à partir de zéro. Ceci est particulièrement vrai pour les JOIN instructions courantes ou les CASE expressions complexes. À mesure que votre liste de queries s'allonge, il peut être difficile de se souvenir quelles queries contiennent l'instruction dont vous avez besoin. Vous pouvez également créer un extrait de query qui contient un point d'insertion avec un texte d'espace réservé qu'un utilisateur peut remplacer au moment de l'exécution.

Les snippets de query sont des segments de query que vous pouvez partager et Trigger à l'aide de l'autocomplétion. Utilisez les extraits de query pour :

• Instructions JOIN fréquentes
• Clauses complexes comme WITH ou CASE.
• Mise en forme conditionnelle

Voici des exemples d'extraits :

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

Créer des extraits de query

Vous pouvez créer un extrait de requête à partir des éditeurs SQL, de Notebook ou de fichier. Suivez ces étapes :

1. Dans le nouvel éditeur SQL, cliquez sur le menu kebab, puis cliquez sur Afficher .

   Dans les éditeurs de Notebook ou de fichiers, cliquez sur **Affichage**.

2. Cliquez sur Extraits de requête .

3. Cliquez sur Créer un extrait de query .

4. Dans le champ Remplacer , saisissez le nom de l'extrait. Vous utiliserez ce nom lors de la rédaction d'une requête qui utilise l'extrait.

5. (Facultatif) Saisissez une description.

6. Dans le champ Extrait , saisissez l'extrait.

7. Cliquez sur Créer .

   

Utiliser un extrait de query

Les extraits de requêtes peuvent être utilisés dans n'importe quelle requête SQL. Vous pouvez accéder aux extraits de query dans l'éditeur SQL, les cellules SQL de Notebook, les fichiers SQL et les query du AI/BI dashboard.

Voici un exemple de simple query avec laquelle vous pouvez utiliser ces extraits de query :

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

Utilisez les étapes suivantes pour utiliser un extrait de query avec cette query :

1. Ouvrir l'éditeur SQL .

2. Saisissez votre query dans le volet de query de l'éditeur SQL.

3. start à taper le nom de votre extrait de requête, puis sélectionnez-le dans la fenêtre de saisie semi-automatique.

   Dans l'éditeur SQL, vous pouvez également ouvrir manuellement la fenêtre avec Control+Space et sélectionner un extrait.

   

4. Exécuter la query avec la clause WHERE de l'extrait de query.

   

Utiliser les points d'insertion dans les extraits de query

Vous désignez les points d'insertion en entourant un ordre de tab entier avec un signe dollar unique et des accolades ${}. Un espace réservé de texte précédé d'un deux-points :est facultatif mais utile pour les utilisateurs peu familiarisés avec votre extrait. Dans les extraits de query avec des points d'insertion que vous avez créés précédemment, ${1:value} est un point d'insertion avec un espace réservé, et ${1:100} est un point d'insertion avec une valeur default pour l'espace réservé que vous pouvez remplacer à l'exécution. Lorsque Databricks SQL affiche l'extrait, le signe dollar $ et les accolades {} sont supprimés, et le mot value ou le default de 100 est mis en surbrillance pour le remplacement.

Lorsqu'il existe plusieurs points d'insertion, le curseur d'insertion de texte passe au premier point d'insertion pour demander la valeur souhaitée. Lorsque vous appuyez sur Tab, le curseur se déplace vers le prochain point d'insertion pour la prochaine valeur. Lorsque vous appuyez à nouveau sur Tab, le curseur passe à la ligne du point d'insertion suivant jusqu'à ce qu'il atteigne le dernier point d'insertion.

remarque

Un point d’insertion de zéro ${0} est toujours le dernier point dans l’ordre des tab.

Suivez les étapes suivantes pour utiliser les extraits de query de point d'insertion avec la query :

1. Ouvrir l'éditeur SQL .

2. Saisissez votre query dans le volet de query de l'éditeur SQL.

3. Saisissez les trois premières lettres du nom de votre extrait de query, puis sélectionnez un extrait de query avec le point d'insertion sans valeur default.

   L'extrait de query est ajouté à la query, et le curseur d'insertion de texte passe au point d'insertion.

   

4. Saisissez une valeur pour la clause WHERE, telle que 200.

5. Éventuellement, exécutez la query avec la clause WHERE de l'extrait de query.

6. Répétez les étapes précédentes, mais sélectionnez l'extrait de requête avec le point d'insertion en utilisant une valeur default.

   

7. Répétez les étapes précédentes, mais sélectionnez l'extrait de query avec plusieurs points d'insertion.

   

8. Saisissez une valeur pour le premier point d'insertion, passez tab au point d'insertion suivant et saisissez une valeur, puis passez tab au point d'insertion final et saisissez une valeur.