Google
Cloud Platform
Amazon Web Services
Microsoft AzureObtenha ajuda de codificação do Databricks Assistant
Este artigo descreve como o senhor pode usar o Databricks Assistant para ajudá-lo a codificar e depurar o Notebook e fornece dicas sobre como aproveitar ao máximo o Assistente.
Em que o Databricks Assistant pode ajudar?
Databricks Assistant é um assistente AI com reconhecimento de contexto com o qual o senhor pode interagir usando uma interface de conversação, tornando-o mais produtivo em Databricks. O senhor pode descrever sua tarefa em inglês e deixar que o assistente gere código Python ou consultas SQL, explique códigos complexos e corrija erros automaticamente. O assistente usa os metadados do site Unity Catalog para entender suas tabelas, colunas, descrições e dados populares ativos em toda a sua empresa para fornecer respostas personalizadas.
Databricks Assistant pode ajudar o senhor com a tarefa a seguir:
Gere código.
Código de depuração, incluindo identificação e sugestão de correções para erros.
Transforme e otimize o código.
Explique o código.
Ajudar o senhor a encontrar informações relevantes na documentação da Databricks.
Para obter informações sobre como habilitar e usar o site Databricks Assistant, consulte Use Databricks Assistant. Para obter informações gerais sobre Databricks Assistant, consulte DatabricksIQ-powered recurso.
Atalhos do comando Assistant para o Notebook
Em um Notebook, o site Databricks Assistant está disponível no painel Assistente ou em linha em uma célula de código.
Para usar o Databricks Assistant diretamente em uma célula de código, pressione Cmd+I no MacOS ou Ctrl+I no Windows. Uma caixa de texto aparece na célula. O senhor pode digitar uma pergunta ou comentário em inglês e, em seguida, pressionar Enter (e não Shift+Enter, como faria para executar uma célula) para que o Assistant gere uma resposta.
Use o comando slash para prompts
Os comandos de barra são um atalho para a criação de prompts comuns.
Texto rápido |
O que o Assistente faz |
|---|---|
|
Exibe o comando comum |
|
Comentários sobre o código em um diff view |
|
Fornece uma explicação do código em uma célula |
|
Propõe uma correção para qualquer erro de código em um diff view |
|
Busca tabelas relevantes com base nos metadados do Unity Catalog. Para localizar recurso ou tabelas de recurso, mencione "recurso" ou "recurso tables" na consulta. Consulte Localizar recurso e tabelas de recurso usando Databricks Assistant. |
|
Busca consultas relevantes com base nos metadados do Unity Catalog. |
|
Melhora as consultas SQL ineficientes. |
|
Formata o código para facilitar a leitura. |
|
Sugere nomes atualizados para células do Notebook e outros elementos, dependendo do contexto. |
|
Ajusta as configurações do Notebook diretamente do Assistant. |
Ao usar /fix ou /doc, na janela diff, selecione Aceitar para aceitar as alterações propostas ou Rejeitar para manter o código original. Se o senhor aceitar o código proposto, o código não será executado automaticamente. Você pode revisar o código antes de executá-lo. Se o código gerado não for o que o senhor queria, tente novamente adicionando mais detalhes ou informações ao seu comentário. Consulte Dicas para usar o Databricks Assistant.
Obtenha explicações detalhadas sobre trechos de código. Use o prompt /explain e inclua termos como “seja conciso” ou “explique o código linha por linha” para solicitar o nível de detalhes desejado. O senhor também pode pedir ao Databricks Assistant para adicionar comentários ao código.
Para o autocompletar de código, o desempenho pode ser melhor usando o painel Assistente do que em uma célula do Notebook.
O Assistente fecha automaticamente se você aceitar ou rejeitar o código gerado.
Obtenha ajuda com o código
O Databricks Assistant ajuda com o código, tanto SQL quanto Python:
AIO preenchimento automático baseado em Databricks Notebook, o editor SQL e o editor de arquivos.
Filtragem de dados com solicitações em linguagem natural.
Depuração de código com Diagnose Error (visualização pública).
Obtenha sugestões de código em linha: Exemplos de Python e SQL
Conforme você digita, as sugestões aparecem automaticamente. Pressione Tab para aceitar uma sugestão. Para acionar manualmente uma sugestão, pressione Option+Shift+Space (no macOS) ou Control+Shift+Space (no Windows).
AIO autocompletar baseado em - também pode gerar código a partir de comentários:
Filtre dados com solicitações de linguagem natural
Use o Databricks Assistant para filtrar as saídas de dados com prompts de linguagem natural.
Para filtrar as saídas com linguagem natural, clique no ícone Filtro na tabela de saída e insira um prompt. Por exemplo, como no exemplo animado a seguir, você pode solicitar “Mostre-me somente homens com mais de 70 anos”.
Código de depuração: Exemplos de Python e SQL
Prévia
Esse recurso está em Prévia Pública.
Para usar o Databricks Assistant para corrigir o código, faça uma das seguintes ações:
Faça uma pergunta no painel Assistente.
Clique no botão Diagnosticar erro que aparece nos resultados da célula quando ocorre um erro.
Clique em Depurar para percorrer interativamente o código linha por linha, definir pontos de interrupção, inspecionar variáveis e analisar a execução de um programa.
A guia abaixo mostra exemplos nos códigos Python e SQL:
Quando o senhor clica em Diagnosticar erro, o Assistente executa automaticamente /fix.
Correção rápida
Quando o código retorna erros, o Quick Fix recomenda automaticamente correções para erros básicos que podem ser corrigidos em uma única alteração de linha.
Clique em Aceitar e executar para fazer a correção recomendada e continuar a executar seu código:
Dicas para usar o Databricks Assistant
Esta seção inclui algumas dicas gerais e práticas recomendadas ao usar o Databricks Assistant.
O Databricks Assistant usa o contexto para fornecer respostas melhores
O Databricks Assistant tem acesso a esquemas e metadados de tabelas e colunas. Isso permite que você use a linguagem natural e gere consultas mais precisas. Por exemplo, se uma tabela tiver uma coluna chamada State (Estado), o senhor pode pedir ao Databricks Assistant para gerar uma lista de usuários que moram em Michigan.
O Databricks Assistant usa o seguinte contexto:
Código ou consultas na célula atual do Notebook ou no editor Databricks SQL tab.
Nomes e descrições de tabelas e colunas.
Perguntas imediatas anteriores.
Tabelas favoritas e ativas.
Para o recurso de diagnóstico de erro, o rastreamento de pilha da saída de erro.
Ao selecionar colunas de um DataFrame, o senhor pode obter resultados mais precisos fornecendo uma consulta inicial. Por exemplo, forneça uma declaração como SELECT * FROM <table_name>. Isso permite que o Databricks Assistant obtenha os nomes das colunas e não tenha que adivinhar.
Como o Databricks Assistant usa o histórico da conversa para fornecer respostas melhores e mais precisas, o senhor pode solicitar ao Databricks Assistant que altere o resultado de uma resposta anterior sem precisar reescrever todo o prompt. Use o histórico de bate-papo do Assistant para limpar, explorar, filtrar e dividir de forma iterativa o site DataFrames no painel do Assistant.
Seja específico
A estrutura e os detalhes que o Databricks Assistant fornece variam de tempos em tempos, até mesmo para o mesmo prompt. Tente fornecer ao Assistant o máximo de orientação possível para ajudá-lo a retornar as informações que o senhor deseja no formato desejado, no nível de detalhe e assim por diante. Por exemplo:
“Explique esse código em algumas frases” ou “Explique esse código linha por linha”.
“Crie uma visualização usando o MatPlotLib” ou “Crie uma visualização usando o Seaborn”.
Dê exemplos de valores de dados em nível de linha
Como o Databricks Assistant não usa dados em nível de linha, talvez seja necessário fornecer mais detalhes aos prompts para obter a resposta mais precisa. Use comentários de tabela ou coluna no Catalog Explorer para adicionar uma linha de dados de amostra. Por exemplo, suponha que sua coluna de altura esteja no formato feet-inches. Para ajudar o Assistente a interpretar os dados, adicione um comentário como "A coluna de altura está no formato de cadeias de caracteres e é separada por um hífen. Exemplo: '6-2'.” Para obter informações sobre comentários em tabelas e colunas, consulte Adicionar comentários aos dados e AI ativo.
Se o senhor precisar usar conversões de tipo de dados de coluna para executar uma operação, talvez seja necessário fornecer detalhes. Por exemplo: "converter este código de Pandas para PySpark, incluindo o código necessário para converter o Pandas DataFrame em um PySpark DataFrame e alterar o tipo de dados da coluna churn de Boolean para integer".
Use Shift+Enter para adicionar uma nova linha na caixa de texto do bate-papo
Use Shift+Enter para adicionar uma nova linha na caixa de texto de bate-papo do Assistente. Isso facilita a formatação e a organização de suas mensagens para o Databricks Assistant.
Editar e executar o código no painel de bate-papo Databricks Assistant
O senhor pode usar o código de execução no painel Assistente para validá-lo ou usá-lo como um bloco de notas. Para executar o código, clique em 
no canto superior esquerdo da caixa de código no painel Assistente.
A guia abaixo mostra exemplos para os códigos Python e SQL:
Quando o senhor executa o código no painel Assistente, a saída é exibida e as variáveis tornam-se utilizáveis no Notebook.
O senhor também pode editar o código que o Databricks Assistant gera diretamente na caixa de bate-papo do Assistente antes de mover o código para o Notebook.