Compartilhar via

Como adicionar comentários gerados por IA a objetos do Catálogo do Unity

Este artigo apresenta comentários de coluna de tabela e objeto do Unity gerados por IA (também conhecido como documentação gerada por IA), explica como eles funcionam e mostra como adicioná-los e editá-los.

Importante

Ao salvar comentários, um ALTER comando SQL é acionado, o que pode afetar pipelines e trabalhos do Azure Databricks.

Para obter detalhes sobre a IA por trás de comentários gerados por IA, consulte a confiança e a segurança dos recursos assistenciais de IA do Databricks.

Objetos com suporte

Os comentários gerados por IA são compatíveis estes objetos do Catálogo do Unity:

  • Catálogos
  • Esquemas
  • Tabelas
  • Visões
  • visões materializadas
  • Colunas da tabela
  • Functions
  • Modelos
  • Volumes

Como funcionam os comentários gerados por IA?

Como proprietário de um objeto ou usuário com permissão para modificar um objeto, você pode usar o Gerenciador de catálogos para ver e adicionar um comentário gerado por IA para objetos e colunas de tabela gerenciados pelo Catálogo do Unity. Os comentários são desenvolvidos por um LLM (modelo de linguagem grande) que considera os metadados do objeto, como o esquema de tabela e os nomes das colunas.

Comentários gerados por IA fornecem uma maneira rápida de ajudar os usuários a descobrir dados gerenciados pelo Unity Catalog.

Importante

Os objetivo dos comentários gerados pela IA é fornecer uma descrição geral de objetos e colunas de tabela com base no esquema. As descrições são ajustadas para dados em um contexto empresarial, usando esquemas de exemplo de vários conjuntos de dados abertos em vários setores. O modelo foi avaliado com centenas de amostras simuladas para verificar se evita gerar descrições prejudiciais nem inadequadas.

Os modelos de IA nem sempre são precisos e os comentários precisam ser revisados antes de salvar. O Databricks recomenda fortemente a revisão humana de comentários gerados por IA para verificar se há imprecisões. Não se deve confiar no modelo para tarefas de classificação de dados, como detectar colunas com PII.

Para exibir os comentários depois que eles forem adicionados, você deve ter o BROWSE privilégio no catálogo. BROWSE permite exibir metadados de objeto, incluindo comentários, sem a necessidade USE CATALOG ou USE SCHEMA privilégios.

Os comentários gerados por IA são um recurso assistencial de IA do Databricks. Para obter informações sobre os modelos usados para gerar sugestões de comentários, consulte os recursos de IA alimentados por parceiros e a segurança dos recursos assistenciais de IA do Databricks.

Adicionar comentários gerados por IA

Você deve usar o Gerenciador de catálogos para ver comentários sugeridos, editá-los e adicioná-los a objetos e colunas de tabelas.

Permissões necessárias:

  • Para a maioria dos objetos (catálogos, esquemas, tabelas, funções, modelos e volumes): você deve ser o proprietário do objeto ou ter o MODIFY privilégio no objeto.
  • Para visões e visões materializadas: você deve ser o proprietário do objeto.

Como adicionar um comentário sugerido por IA a um objeto

  1. No workspace do Azure Databricks, clique no ícone Dados.Catálogo.

  2. Pesquise ou procure pelo objeto e selecione-o.

  3. No painel Sobre este <object>, clique em Gerar com IA.

    Botão Comentários gerados por IA

    Pode demorar um pouco para a IA gerar o comentário.

  4. Clique em Aceitar para aceitar o comentário sem alterações ou Editar para modificá-lo antes de salvá-lo.

Como adicionar um comentário sugerido por IA a uma coluna de tabela

  1. No workspace do Azure Databricks, clique no ícone Dados.Catálogo.

  2. Pesquise ou procure a tabela e selecione-a.

  3. Logo acima dos títulos das colunas da tabela, clique em Gerar com IA.

    Um comentário é gerado para cada coluna.

  4. Clique na marca de seleção próxima ao comentário da coluna para aceitá-lo ou fechá-lo sem salvar.

Atualizar um comentário gerado por IA

O proprietário do objeto ou usuário com o privilégio MODIFY no objeto pode atualizar os comentários a qualquer momento, usando a interface do usuário do Gerenciador de catálogos. O assistente de chat integrado ajuda a editar comentários, fornecendo opções para Abreviar texto ou Traduzir texto para um idioma diferente.

Assistente integrado de comentários gerados por IA

Você também pode usar comandos SQL ALTER ou COMMENT ON.

Privacidade e segurança

Para perguntas frequentes sobre privacidade e segurança, consulte as perguntas frequentes sobre privacidade e segurança para recursos assistenciais de IA.

  • Last updated on