Obtenir de l’aide sur le codage à partir de l’Assistant Databricks

Cet article explique comment utiliser l’Assistant Databricks pour vous aider à coder et déboguer vos notebooks et fournit des conseils sur la façon de tirer le meilleur parti de l’Assistant.

Comment l’Assistant Databricks peut-il vous aider ?

L’Assistant Databricks est un assistant IA prenant en charge le contexte avec lequel vous pouvez interagir à l’aide d’une interface conversationnelle, ce qui vous rend plus productif dans Databricks. Vous pouvez décrire votre tâche en anglais et laisser l’Assistant générer du code Python ou des requêtes SQL, expliquer le code complexe et corriger automatiquement les erreurs. L’assistant utilise les métadonnées du catalogue Unity pour comprendre vos tables, colonnes, descriptions et ressources de données populaires au sein de votre entreprise pour fournir des réponses personnalisées.

L’Assistant Databricks peut vous aider à effectuer les tâches suivantes :

• Générez du code.
• Déboguer le code, y compris l’identification et la suggestion de correctifs pour les erreurs.
• Transformez et optimisez le code.
• Expliquer le code.
• Aidez-vous à trouver des informations pertinentes dans la documentation Azure Databricks.

Pour plus d’informations sur l’activation et l’utilisation de l’Assistant Databricks, consultez Activer et essayer l’Assistant Databricks. Pour des informations générales sur l'Assistant Databricks, consultez les fonctionnalités propulsées par DatabricksIQ .

Raccourcis de commande Assistant pour les notebooks

Dans un notebook, l’Assistant Databricks est disponible dans le volet Assistant ou en ligne dans une cellule de code.

Pour utiliser l’Assistant Databricks directement dans une cellule de code, appuyez sur Cmd+I sur MacOS ou Ctrl+I sur Windows. Une zone de texte apparaît dans la cellule. Vous pouvez taper une question ou un commentaire en anglais, puis appuyer sur Enter (pas Shift+Enter, comme vous le feriez pour exécuter une cellule) pour que l’Assistant génère une réponse.

Utiliser des commandes de barre oblique pour les invites

Les commandes de barre oblique sont un raccourci pour créer des prompts courants.

Lorsque vous utilisez /fix ou /doc, dans la fenêtre de comparaison, sélectionnez Accepter pour accepter les modifications proposées ou Rejeter pour conserver le code d’origine. Si vous acceptez le code proposé, le code ne s’exécute pas automatiquement. Vous pouvez passer en revue le code avant de l’exécuter. Si le code généré n’est pas ce que vous souhaitez, réessayez en ajoutant plus de détails ou d’informations à votre commentaire. Consultez Conseils pour utiliser l’Assistant Databricks.

Découvrez des explications détaillées sur les extraits de code. Utilisez l’invite /explain et incluez des termes tels que « sois concis » ou « explique le code ligne par ligne » pour préciser le niveau de détail souhaité. Vous pouvez également demander à l’Assistant Databricks d’ajouter des commentaires au code.

Pour la saisie semi-automatique du code, les performances peuvent être meilleures à l’aide du volet Assistant que dans une cellule de notebook.

L’assistant se ferme automatiquement si vous acceptez ou refusez le code qu’il a généré.

Tables de référence dans les fenêtres d’invite via @

Pour référencer rapidement des tables dans les invites d’Assistant, utilisez le symbole @ (arobase).

Obtenir de l’aide pour du code

L’Assistant Databricks apporte une aide sur le code, à la fois SQL et Python :

• Autocomplétion basée sur l’IA dans des notebooks Databricks, dans l’éditeur SQL et dans l’éditeur de fichiers.
• Filtrage de données avec des prompts en langage naturel.
• Débogage de code avec Diagnostiquer l’erreur (préversion publique).

Obtenir des suggestions de code inline : exemples Python et SQL

Lorsque vous tapez, les suggestions s’affichent automatiquement. Appuyez sur Tab pour accepter une suggestion. Pour déclencher manuellement une suggestion, appuyez sur Option+Shift+Space (sur macOS) ou sur Control+Shift+Space (sur Windows).

L’autocomplétion basée sur l’IA peut également générer du code à partir de commentaires :

Filtrer les données avec des invites en langage naturel

Utilisez l’Assistant Databricks pour filtrer les sorties de données avec des prompts en langage naturel.

Pour filtrer les sorties en langage naturel, cliquez sur l’icône Filtrer dans la table de sortie et entrez un prompt. Par exemple, comme dans l’exemple animé suivant, vous pouvez demander « Afficher seulement les hommes de plus de 70 ans ».

Débogage de code : exemples Python et SQL

Pour utiliser l’Assistant Databricks pour corriger le code, effectuez l’une des opérations suivantes :

• Posez une question dans le volet Assistant.
• Cliquez sur le bouton Diagnostiquer l’erreur qui s’affiche dans les résultats de la cellule lorsqu’une erreur se produit.
• Cliquez sur Déboguer pour exécuter le code pas à pas de façon interactive ligne par ligne, définir des points d’arrêt, inspecter les variables et analyser l’exécution du programme.

Les onglets ci-dessous présentent des exemples de code Python et SQL :

Python

SQL

Lorsque vous cliquez sur Diagnostiquer l’erreur, Assistant s’exécute automatiquement /fix.

Correctif rapide

Lorsque le code retourne des erreurs, le Correctif rapide recommande automatiquement des corrections pour les erreurs de base qui peuvent être corrigées par un simple changement d’une ligne.

Cliquez sur Accepter et exécuter pour effectuer la correction recommandé et continuer à exécuter votre code :

Conseils pour l’utilisation de l’Assistant Databricks

Cette section contient des conseils généraux et des meilleures pratiques lors de l’utilisation de l’Assistant Databricks.

L’Assistant Databricks utilise le contexte pour fournir de meilleures réponses

L’Assistant Databricks a accès aux schémas de table et de colonne et aux métadonnées. Cela vous permet d’utiliser le langage naturel et de générer des requêtes plus précises. Par exemple, si une table a une colonne nommée État, vous pouvez demander à l’Assistant Databricks de générer une liste d’utilisateurs qui vivent dans l’État du Michigan.

L’Assistant Databricks utilise le contexte suivant :

• Code ou requêtes dans la cellule de notebook ou l’onglet de l’éditeur Databricks SQL actuels.
• Noms et descriptions des tables et des colonnes.
• Questions d’invite précédentes.
• Tables favorites et actives.
• Pour la fonctionnalité de Diagnostiquer une erreur, la trace de pile de la sortie d’erreur.

Lorsque vous sélectionnez des colonnes à partir d’un DataFrame, vous pouvez obtenir des résultats plus précis en fournissant une requête de démarrage. Par exemple, fournissez une instruction telle que SELECT * FROM <table_name>. Cela permet à l’Assistant Databricks d’obtenir les noms de colonnes et de ne pas avoir à deviner.

Étant donné que l’Assistant Databricks utilise votre historique des conversations pour fournir des réponses meilleures et plus précises, vous pouvez demander à l’Assistant Databricks de modifier la sortie d’une réponse précédente sans avoir à réécrire toute l’invite. Utilisez l’historique des discussions d’Assistant pour nettoyer, explorer, filtrer et découper de manière itérative les DataFrames dans le volet Assistant.

Soyez spécifique

La structure et les détails que l’Assistant Databricks fournit varient de temps en temps, même pour la même invite. Essayez de fournir à Assistant autant de conseils que vous pouvez pour l’aider à renvoyer les informations souhaitées dans le format et le niveau de détail souhaités, et selon d’autres critères. Exemple :

• « Explique ce code en quelques phrases » ou « Explique ce code ligne par ligne ».
• “Créez une visualisation à l’aide de MatPlotLib” ou “créez une visualisation à l’aide de Seaborn”.

Donnez des exemples de valeurs de données au niveau des lignes

Étant donné que l’Assistant Databricks n’utilise pas de données au niveau des lignes, vous devrez peut-être fournir plus de détails aux invites pour obtenir la réponse la plus précise. Utilisez des commentaires de table ou de colonne dans l’Explorateur de catalogues pour ajouter une ligne d’exemples de données. Par exemple, supposons que votre colonne de hauteur soit au format feet-inches. Pour aider Assistant à interpréter les données, ajoutez un commentaire tel que « La colonne de hauteur est au format chaîne et est séparée par un trait d’union. Exemple : ‘6-2’. » Pour plus d’informations sur les commentaires de table et de colonne, consultez Ajouter des commentaires aux ressources d’IA et de données.

Si vous devez utiliser des conversions de type de données de colonne pour exécuter une opération, vous devrez peut-être fournir des détails. Par exemple : « convertit ce code de pandas en PySpark, y compris le code nécessaire pour convertir le DataFrame pandas en un PySpark DataFrame et en changeant le type de données d’attrition de colonne Booléen pour Entier ».

Utiliser Maj+Entrée pour ajouter une nouvelle ligne dans la zone de texte de conversation

Utilisez Maj+Entrée pour ajouter une nouvelle ligne dans la zone de texte de conversation de l’Assistant. Cela facilite la mise en forme et l’organisation de vos messages dans l’Assistant Databricks.

Modifier et exécuter du code dans le volet de conversation de l’Assistant Databricks

Exécutez du code dans le volet Assistant pour le valider ou l’utiliser comme bloc-notes. Pour exécuter du code, cliquez sur dans le coin supérieur gauche de la zone de code dans le volet Assistant.

Les onglets ci-dessous présentent des exemples de code Python et SQL :

Python

SQL

Lorsque vous exécutez du code dans le volet Assistant, la sortie s’affiche et les variables deviennent utilisables dans le notebook.

Vous pouvez également modifier le code généré par l’Assistant Databricks directement dans la zone de conversation de l’Assistant avant de déplacer le code vers le notebook.

Informations supplémentaires

Les articles suivants contiennent des informations supplémentaires sur l’utilisation de l’Assistant Databricks :

• Qu’est-ce que l’Assistant Databricks ?
• Activer et essayer l’Assistant Databricks
• Confiance et sécurité de DatabricksIQ
• Mesurer l’impact de l’Assistant Databricks