Extraits de code de requête

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

Les extraits de code de requête sont des segments de requêtes que vous pouvez partager et déclencher à l’aide de l’autocomplétion. Utilisez des extraits de requête pour :

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

Voici quelques 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 requête

Utilisez les étapes suivantes pour créer des extraits en utilisant ces exemples d’extrait :

1. Cliquez sur votre nom d’utilisateur dans la barre supérieure de l’espace de travail, puis sélectionnez Paramètres dans la liste déroulante.

2. Cliquez sur l’onglet Développeur.

3. À côté de Extraits de requête SQL cliquez sur Gérer.

4. Cliquez sur Créer un extrait de requête.

5. Dans le champ Remplacer, entrez le nom d’extrait. Vous utilisez ce nom lors de l’écriture d’une requête qui utilise l’extrait.

6. Entrez éventuellement une description.

7. Dans le champ Extrait de code, entrez l’extrait de code.

8. Cliquez sur Créer.

   

Utiliser un extrait de requête dans une requête

Voici un exemple de requête simple avec lequel vous pouvez utiliser ces extraits de requête :

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

Utilisez les étapes suivantes pour utiliser un extrait de requête avec cette requête :

1. Ouvrez l’Éditeur SQL.

2. Tapez votre requête dans le volet de requête de l’Éditeur SQL.

3. Tapez les trois premières lettres du nom d’extrait, puis sélectionnez un extrait à partir de la fenêtre d’autocomplétion. Vous pouvez également ouvrir la fenêtre en appuyant Option + Space et en sélectionnant un extrait.

   

4. Exécutez la requête avec la clause WHERE à partir de l’extrait de requête.

   

Utiliser des points d’insertion dans des extraits de requête

Vous pouvez désigner des points d’insertion en entourant un ordre de tabulation entier avec un seul signe dollar et des accolades ${}. Un texte d’espace réservé précédé d’un signe deux-points : est facultatif, mais utile pour les utilisateurs qui ne sont pas familiarisés avec votre extrait de code. Dans les extraits de requête avec des points d’insertion 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 un valeur par défaut pour l’espace réservé que vous pouvez remplacer au moment du runtime. Lorsque Databricks SQL restitue l’extrait, le signe dollar $ et les accolades {} sont supprimés et le mot value ou la valeur par défaut de 100 est mise en surbrillance pour être remplacé.

Lorsqu’il existe plusieurs points d’insertion, le carat d’insertion de texte passe au premier point d’insertion pour l’invite de valeur souhaitée. Lorsque vous appuyez sur Tab, le carat passe au point d’insertion suivant pour la prochaine valeur. Lorsque appuyez à nouveau sur Tab, le carat passe à la ligne de point d’insertion suivant jusqu’à ce qu’il atteigne le point d’insertion final.

Remarque

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

Utilisez les étapes suivantes pour utiliser les extraits de requête de point d’insertion avec la requête :

1. Ouvrez l’Éditeur SQL.

2. Tapez votre requête dans le volet de requête de l’Éditeur SQL.

3. Tapez les trois premières lettres du nom de votre extrait de requête, puis sélectionnez un extrait de requête avec le point d’insertion sans aucune valeur par défaut.

   L’extrait de requête est ajouté à la requête et le carat de texte d’insertion passe au point d’insertion.

   

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

5. Vous pouvez exécuter la requête avec la clause WHERE à partir de l’extrait de requête.

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 par défaut.

   

7. Répétez les étapes précédentes, mais sélectionnez l’extrait de requête avec plusieurs points d’insertion.

   

8. Entrez une valeur pour le premier point d’insertion, accédez au point d’insertion suivant et entrez une valeur, puis accédez au point d’insertion final pour entrer une valeur.