Partilhar via


Adicionar comentários gerados por IA a objetos do Unity Catalog

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

Importante

Salvar comentários aciona um comando SQL ALTER, que pode interromper os pipelines e trabalhos do Azure Databricks.

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

Objetos suportados

Comentários gerados por IA são suportados para os seguintes objetos do Unity Catalog:

  • Catálogos
  • Esquemas
  • Tabelas
  • Views
  • visões materializadas
  • Colunas da tabela
  • Funções
  • Modelos
  • Volumes

Como funcionam os comentários gerados por IA?

Como proprietário de um objeto ou um usuário com permissão para modificar um objeto, você pode usar o Catalog Explorer para exibir e adicionar um comentário gerado por IA para objetos e colunas de tabela gerenciados pelo Unity Catalog. Os comentários são alimentados por um modelo de linguagem grande (LLM) que leva em conta metadados de objeto, como o esquema de tabela e nomes de coluna.

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

Importante

Os comentários gerados por IA destinam-se a 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 e 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 ou inadequadas.

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

Para ver os comentários depois de adicionados, deve ter o BROWSE privilégio no catálogo. BROWSE permite visualizar metadados de objetos, incluindo comentários, sem necessitar de USE CATALOG ou de privilégios USE SCHEMA.

Os comentários gerados por IA são um recurso auxiliar 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 as Funcionalidades assistivas de IA do Databricks para confiança e segurança.

Adicionar comentários gerados por IA

Você deve usar o Gerenciador de Catálogos para exibir comentários sugeridos, editá-los e adicioná-los a objetos e colunas de tabela.

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 visualizações e visualizações materializadas: Você deve ser o proprietário do objeto.

Adicionar um comentário sugerido por IA a um objeto

  1. No seu espaço de trabalho do Azure Databricks, clique no ícone Dados.Catálogo.

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

  3. No painel Sobre este <object>, clique em AI gerar.

    Botão de comentários gerados por IA

    A IA pode demorar um pouco para gerar o comentário.

  4. Clique em Aceitar para aceitar o comentário no estado em que se encontra ou em Editar para modificá-lo antes de salvá-lo.

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

  1. No seu espaço de trabalho do Azure Databricks, clique no ícone Dados.Catálogo.

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

  3. Acima dos cabeçalhos das colunas da tabela, clique IA gerar.

    Um comentário é gerado para cada coluna.

  4. Clique na marca de seleção ao lado do comentário da coluna para aceitá-lo ou fechar sem ser guardado.

Atualizar um comentário gerado por IA

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

Assistente inline de comentários gerados por IA

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

Privacidade e segurança

Para perguntas frequentes sobre privacidade e segurança, consulte as Perguntas frequentes sobre privacidade e segurança para recursos de assistência à IA.