Extraits de code de requête

Il est souvent plus facile de dupliquer le travail antérieur et de 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 augmente, il peut être difficile de mémoriser les requêtes qui contiennent l’instruction dont vous avez besoin. Vous pouvez également créer un extrait de code de requête qui contient un point d'insertion avec un texte de substitution qu’un utilisateur peut remplacer pendant l'exécution.

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 telles que WITH ou CASE.
• Mise en forme conditionnelle

Voici des exemples d’extraits de code :

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

Pour créer des extraits de code à l’aide de ces exemples d’extraits de code, procédez comme suit :

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 de l’extrait de code. Vous utiliserez ce nom lors de l’écriture d’une requête à l’aide de l’extrait de code.

6. Si vous le souhaitez, entrez une description.

7. Dans le champ Snippet, entrez l’extrait.

8. Cliquez sur Créer.

   

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

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

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

Pour utiliser un extrait de requête avec cette requête, procédez comme suit :

1. Ouvrez Éditeur SQL.

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

3. Tapez les 3 premières lettres du nom de l’extrait de code, puis sélectionnez un extrait dans la fenêtre de saisie semi-automatique. Vous pouvez également ouvrir manuellement la fenêtre en appuyant sur Option + Space et en sélectionnant un extrait de code.

   

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 espace réservé de texte précédé d’un signe deux-points :est facultatif mais utile pour les utilisateurs qui ne connaissent pas votre extrait de code. Dans les extraits de requête 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 par défaut pour l’espace réservé que vous pouvez remplacer au moment de l’exécution. 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 demander la valeur souhaitée. Lorsque vous appuyez sur Tab, le carat passe au point d’insertion suivant pour la valeur suivante. Lorsque vous appuyez à nouveau sur Tab, le carat passe à la ligne de point d’insertion suivante 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 Éditeur SQL.

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

3. Tapez les 3 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 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. Si vous le souhaitez, exécutez 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 à l’aide d’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, passez au point d’insertion suivant et entrez une valeur, puis passez au point d’insertion final et entrez une valeur.