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 requête sont des portions 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

Vous pouvez créer un extrait de requête à partir des éditeurs sql, notebook ou de fichiers. Suivez ces étapes :

1. Dans l’éditeur SQL, cliquez sur Menu kebab.

   Dans le nouvel éditeur SQL, cliquez sur Menu Kebab, puis cliquez sur Afficher.

   Dans les éditeurs de bloc-notes ou de fichiers, cliquez sur Afficher.

2. Cliquez sur Extraits de requête.

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

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

5. (En option) Saisissez une description.

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

7. Cliquez sur Créer.

   

Utiliser un extrait de requête

Les extraits de requête peuvent être utilisés dans n’importe quelle requête SQL. Vous pouvez accéder aux extraits de requête dans l’éditeur SQL, les cellules SQL du notebook, les fichiers SQL et les requêtes de tableau de bord IA/BI.

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. Commencez à 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 et Control+Space sélectionner 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 de code, le signe $ dollar et les accolades {} sont supprimés, et le mot value ou la valeur par défaut de 100 est mis en surbrillance pour être remplacé.

Lorsqu’il existe plusieurs points d’insertion, le point d’insertion du texte passe au premier point d’insertion pour demander la valeur souhaitée. Lorsque vous appuyez sur Tab, le curseur passe au point d'insertion suivant pour la valeur suivante. Lorsque vous appuyez à nouveau sur Tab, le curseur de saisie passera à la ligne de point d’insertion suivante 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 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 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 valeur par défaut.

   L’extrait de code de requête est ajouté à la requête, et le curseur de texte se déplace vers le point de saisie.

   

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 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, entrez une valeur, puis passez au point d’insertion final et entrez une valeur.