Hulp bij coderen van Databricks Assistant
In dit artikel wordt beschreven hoe u Databricks Assistant kunt gebruiken om u te helpen bij het codeeren en opsporen van fouten in uw notebooks en tips voor het optimaal benutten van de Assistent.
Wat kan Databricks Assistant helpen?
Databricks Assistant is een contextbewuste AI-assistent waarmee u kunt communiceren met behulp van een conversationele interface, waardoor u productiever bent in Databricks. U kunt uw taak in het Engels beschrijven en de assistent Python-code of SQL-query's laten genereren, complexe code uitleggen en fouten automatisch oplossen. De assistent gebruikt metagegevens van Unity Catalog om inzicht te krijgen in uw tabellen, kolommen, beschrijvingen en populaire gegevensassets in uw bedrijf om persoonlijke antwoorden te bieden.
Databricks Assistant kan u helpen met de volgende taken:
- Code genereren.
- Fouten opsporen in code, inclusief het identificeren en voorstellen van oplossingen voor fouten.
- Code transformeren en optimaliseren.
- Code uitleggen.
- Help u relevante informatie te vinden in de documentatie van Azure Databricks.
Zie Databricks Assistant inschakelen en uitproberenvoor meer informatie over het inschakelen en gebruiken van Databricks Assistant. Zie DatabricksIQ-aangedreven functiesvoor algemene informatie over Databricks Assistant.
-assistent opdrachtensnelkoppelingen voor notitieblokken
In een notebook is Databricks Assistant beschikbaar in het deelvenster Assistent of inline in een codecel.
Als u Databricks Assistant rechtstreeks in een codecel wilt gebruiken, drukt u op Cmd+I macOS of Ctrl+I in Windows. Er wordt een tekstvak weergegeven in de cel. U kunt een vraag of opmerking in het Engels typen en vervolgens op Enter drukken (niet op Shift+Enter, zoals u zou doen om een cel uit te voeren) om de Assistent een antwoord te laten genereren.
De slash-opdrachten gebruiken voor prompts
Slash-opdrachten zijn een snelkoppeling voor het maken van gebruikelijke prompts.
| Prompttekst | Wat Assistent doet |
|---|---|
/ |
Algemene opdrachten weergeven |
/doc |
Commentaar geven op de code in een diff-weergave |
/explain |
Geeft een uitleg van de code in een cel |
/fix |
Stelt een oplossing voor eventuele codefouten in een diff-weergave |
/findTables |
Hiermee wordt gezocht naar relevante tabellen op basis van metagegevens van Unity Catalog. Als u functies of functietabellen wilt zoeken, vermeldt u 'functies' of 'functietabellen' in de query. Zie Functies en functietabellen zoeken met databricks Assistant. |
/findQueries |
Hiermee wordt gezocht naar relevante query's op basis van metagegevens van Unity Catalog. |
/optimize |
Verbetert inefficiënte SQL-query's. |
/prettify |
Code wordt opgemaakt voor leesbaarheid. |
/rename |
Stelt bijgewerkte namen voor notitieblokcellen en andere elementen voor, afhankelijk van de context. |
/settings |
Hiermee worden de instellingen van uw notitieblok rechtstreeks vanuit Assistent aangepast. |
Wanneer u /fix of /docgebruikt, selecteert u in het venster Diff Accepteren om de voorgestelde wijzigingen te accepteren of Weigeren om de oorspronkelijke code te behouden. Als u de voorgestelde code accepteert, wordt de code niet automatisch uitgevoerd. U kunt de code controleren voordat u deze uitvoert. Als de gegenereerde code niet is wat u wilt, probeert u het opnieuw door meer details of informatie toe te voegen aan uw opmerking. Zie Tips voor het gebruik van Databricks Assistant.
Krijg gedetailleerde uitleg van codefragmenten. Gebruik de /explain prompt en neem termen op zoals 'beknopt' of 'uitleg code line-by-line' om het gewenste detailniveau aan te vragen. U kunt Databricks Assistant ook vragen opmerkingen aan de code toe te voegen.
Voor automatisch aanvullen van code zijn de prestaties mogelijk beter met behulp van het deelvenster Assistent dan in een notebookcel.
De assistent wordt automatisch gesloten als u Accepteren of Weigeren de code die deze heeft gegenereerd.
Referentietabellen in prompts met behulp van @
Als u snel wilt verwijzen naar tabellen in assistentprompts, gebruikt u het symbool @ (at).
Hulp krijgen bij code
Databricks Assistant helpt bij code, zowel SQL als Python:
- Automatisch aanvullen op basis van AI in Databricks-notebooks, de SQL-editor en de bestandseditor.
- Gegevens filteren met prompts in natuurlijke taal.
- Codefoutopsporing met Fout vaststellen (openbare preview).
Notitie
Inline-codesuggesties zijn niet beschikbaar in Azure Government-regio's of werkruimten met FedRAMP-naleving.
Inline-codesuggesties ophalen: Python- en SQL-voorbeelden
Terwijl u typt, worden suggesties automatisch weergegeven. Druk op Tab om een suggestie te accepteren. Als u handmatig een suggestie wilt activeren, drukt u op Option+Shift+Space (op macOS) of Control+Shift+Space (in Windows).
Automatisch aanvullen op basis van AI kan ook code genereren op basis van opmerkingen:
Gegevens filteren met prompts voor natuurlijke taal
Gebruik Databricks Assistant om gegevensuitvoer te filteren met prompts in natuurlijke taal.
Als u uitvoer met natuurlijke taal wilt filteren, klikt u op het filterpictogram in de uitvoertabel en voert u een prompt in. Zoals in het onderstaande animatievoorbeeld kunt u vragen: 'Toon mij alleen mannen ouder dan 70?'
Foutopsporingscode: Python- en SQL-voorbeelden
Belangrijk
Deze functie bevindt zich in openbare preview-versie.
Ga op een van de volgende manieren te werk om Databricks Assistant te gebruiken om code op te lossen:
- Stel een vraag in het deelvenster Assistent.
- Klik op de knop Fout diagnosticeren die wordt weergegeven in de celresultaten wanneer er een fout optreedt.
- Klik op Debug om interactief de code line-by-line te doorlopen, onderbrekingspunten in te stellen, variabelen te inspecteren en de uitvoering van een programma te analyseren.
In de onderstaande tabbladen ziet u voorbeelden in Python en SQL-code:
Python
SQL
Wanneer u op Fout vaststellenklikt, wordt assistent automatisch /fixuitgevoerd.
snelle oplossing voor
Wanneer code fouten retourneert, raadt Quick Fix automatisch oplossingen aan voor basisfouten die kunnen worden opgelost in één regelwijziging.
Klik op Accepteren en voer uit om de aanbevolen oplossing te maken en door te gaan met het uitvoeren van uw code:
Tips voor het gebruik van Databricks Assistant
Deze sectie bevat enkele algemene tips en aanbevolen procedures bij het gebruik van Databricks Assistant.
Databricks Assistant gebruikt context om betere antwoorden te geven
Databricks Assistant heeft toegang tot tabel- en kolomschema's en metagegevens. Hierdoor kunt u natuurlijke taal gebruiken en nauwkeurigere query's genereren. Als een tabel bijvoorbeeld een kolom bevat met de naam State, kunt u Databricks Assistant vragen een lijst te genereren met gebruikers die in Michigan wonen.
Databricks Assistant gebruikt de volgende context:
- Code of queries in de huidige notebookcel of het SQL-editor-tabblad van Databricks.
- Tabel- en kolomnamen en -beschrijvingen.
- Vorige promptvragen.
- Favoriete en actieve tabellen.
- Voor de foutdiagnosefunctie van kenmerk, het stacktracé vanuit de foutuitvoer.
Wanneer u kolommen in een DataFrame selecteert, kunt u nauwkeurigere resultaten krijgen door een beginquery op te geven. Geef bijvoorbeeld een verklaring op zoals SELECT * FROM <table_name>. Hierdoor kan Databricks Assistant de kolomnamen ophalen en hoeft u niet te raden.
Omdat Databricks Assistant uw gespreksgeschiedenis gebruikt om betere en nauwkeurigere antwoorden te geven, kunt u Databricks Assistant vragen om de uitvoer van een vorig antwoord te wijzigen zonder de hele prompt opnieuw te hoeven schrijven. Gebruik de chatgeschiedenis van assistent om dataframes iteratief op te schonen, te verkennen, te filteren en te segmenteren in het deelvenster Assistent.
Wees specifiek
De structuur en details die Databricks Assistant biedt, varieert van tijd tot tijd, zelfs voor dezelfde prompt. Probeer de Assistent zo veel mogelijk richtlijnen te geven om te helpen de informatie te retourneren in het gewenste formaat, detailniveau, enzovoort. Bijvoorbeeld:
- "Leg deze code in een paar zinnen uit" of "Leg deze code line-by-line uit".
- Een visualisatie maken met MatPlotLib of een visualisatie maken met Seaborn.
Voorbeelden geven van gegevenswaarden op rijniveau
Omdat Databricks Assistant geen gegevens op rijniveau gebruikt, moet u mogelijk meer details geven om te vragen om het meest nauwkeurige antwoord te krijgen. Gebruik tabel- of kolomopmerkingen in Catalog Explorer om een regel met voorbeeldgegevens toe te voegen. Stel dat de hoogtekolom de indeling feet-inchesheeft. Om de Assistant te helpen de gegevens te interpreteren, voeg een opmerking toe zoals 'De kolom hoogte is in stringformaat en wordt gescheiden door een afbreekstreepje'. Voorbeeld: '6-2'. Zie Opmerkingen toevoegen aan gegevens en AI-assetsvoor informatie over tabel- en kolomopmerkingen.
Als u conversies van kolomgegevenstypen moet gebruiken om een bewerking uit te voeren, moet u mogelijk details opgeven. Bijvoorbeeld: 'converteer deze code van pandas naar PySpark, inclusief de code die nodig is om het Pandas DataFrame te converteren naar een PySpark DataFrame en het gegevenstype van kolomverloop te wijzigen van booleaanse waarde in geheel getal'.
Shift+Enter gebruiken om een nieuwe regel toe te voegen in het chattekstvak
Gebruik Shift+Enter om een nieuwe regel toe te voegen in het tekstvak van de Assistent-chat. Hierdoor kunt u uw berichten eenvoudig opmaken en ordenen in Databricks Assistant.
Code bewerken en uitvoeren in het chatvenster van Databricks Assistant
Voer code uit in het deelvenster Assistent om deze te valideren of als kladblok te gebruiken. Als u code wilt uitvoeren, klikt u op 
in de linkerbovenhoek van het codevak in het venster van de Assistent.
In de onderstaande tabbladen ziet u voorbeelden voor Python- en SQL-code:
Python
SQL
Wanneer u code uitvoert in het deelvenster Assistent, wordt de uitvoer weergegeven en worden de variabelen bruikbaar in het notebook.
U kunt ook de code bewerken die Databricks Assistant rechtstreeks in het chatvak Assistent genereert voordat u de code naar het notebook verplaatst.
Aanvullende informatie
De volgende artikelen bevatten aanvullende informatie over het gebruik van Databricks Assistant: