Adicionar comentários gerados pelo site AIaos objetos Unity Catalog

Esta página apresenta os comentários de objetos e colunas de tabelas Unity Catalog gerados AI(também conhecidos como documentação gerada AI ), explica como eles funcionam e mostra como adicioná-los e editá-los.

importante

O salvamento de comentários aciona um comando ALTER SQL, que pode interromper o pipeline Databricks e o trabalho.

Para obter detalhes sobre a AI por trás dos comentários gerados AI , consulte Confiança e segurança do recurso assistivo AI Databricks.

Objetos suportados

AIOs comentários gerados são compatíveis com os seguintes objetos do site Unity Catalog:

• Catálogos
• Esquemas
• tabelas
• Exibições
• Visualizações materializadas
• Colunas da tabela
• Funções
• Modelos
• Volumes

Como funcionam os comentários gerados pelo site AI?

Como proprietário de um objeto ou usuário com permissão para modificar um objeto, o senhor pode usar o Catalog Explorer para view e adicionar um comentário gerado por AIpara objetos e colunas de tabela gerenciados por Unity Catalog. Os comentários são alimentados por um grande modelo de linguagem (LLM) que leva em consideração os metadados do objeto account, como o esquema da tabela e os nomes das colunas.

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

Não existe uma opção para ativar ou desativar os comentários gerados AI , seja no nível workspaceou do catálogo. Os comentários são gerados individualmente para cada objeto quando você os solicita através do Explorador de Catálogo. Após o Databricks gerar um comentário sugerido, você pode revisá-lo e aceitá-lo como está ou editá-lo antes de salvar.

importante

AI-Os comentários gerados têm o objetivo de fornecer uma descrição geral dos objetos e das colunas da tabela com base no esquema. As descrições são ajustadas para dados em um contexto comercial e empresarial, usando esquemas de exemplo de vários conjuntos de dados abertos de várias indústrias. O modelo foi avaliado com centenas de amostras simuladas para verificar se ele evita gerar descrições prejudiciais ou inadequadas.

AI Os modelos nem sempre são precisos e os comentários devem ser revisados antes de serem salvos. Databricks recomenda enfaticamente a revisão humana dos comentários gerados pelo AIpara verificar se há imprecisões. Não se deve confiar no modelo para tarefas de classificação de dados, como a detecção de colunas com PII.

Para view os comentários depois de serem adicionados, você deve ter o privilégio BROWSE no catálogo. BROWSE permite view metadados de objetos, incluindo comentários, sem exigir privilégios de USE CATALOG ou USE SCHEMA .

Comentários gerados por AIsão um recurso assistivo AI Databricks. Para obter informações sobre os modelos usados para gerar sugestões de comentários, consulte recurso AI com tecnologia de parceiros e recurso assistencial AI Databricks confiança e segurança.

Adicionar comentários gerados pelo site AI

O senhor deve usar o Catalog Explorer para acessar view os 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 privilégio MODIFY no objeto.
• Para visualização e visualização materializada: você precisa ser o proprietário do objeto.

Adicionar um comentário sugerido pelo site AIa um objeto

1. Em seu site Databricks workspace, clique em Catalog .

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

3. No painel About this <object> , clique em AI generate .

   

   O site AI pode demorar um pouco para gerar o comentário.

4. Clique em Aceitar para aceitar o comentário como está ou em Editar para modificá-lo antes de salvá-lo.

Adicionar um comentário sugerido pelo site AIa uma coluna da tabela

1. Em seu site Databricks workspace, clique em Catalog .
2. Pesquise ou procure a tabela e selecione-a.
3. Acima dos cabeçalhos das colunas da tabela, clique em GerarAI . 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 fechá-lo sem ser salvo.

Alterar o idioma default para comentários gerados AI

Por default, os comentários gerados AIsão escritos no idioma definido nas configurações da interface do usuário do seu workspace Databricks . Você pode substituir essa configuração usando o seletor de idioma no cartão de Descrição Sugerida pelaAI . Sua seleção é salva no armazenamento local do seu navegador e se aplica a todas as solicitações de comentários subsequentes geradas AIem todos os tipos de entidade compatíveis.

Para alterar o idioma:

1. Após gerar um comentário, clique no Ícone de menu de opções no canto superior direito do cartão de Descrição Sugerida pelaAI .
2. Clique Alterar idioma default .
3. Selecione um idioma da lista.

Na próxima vez que você gerar um comentário para qualquer objeto compatível, o Databricks usará o idioma selecionado.

Atualizar um comentário gerado pelo site AI

O proprietário ou usuário do objeto com o privilégio MODIFY no objeto pode atualizar os comentários a qualquer momento, usando a interface do usuário do Catalog Explorer. O assistente de bate-papo em linha ajuda a editar comentários, oferecendo opções para encurtar texto ou traduzir texto para um idioma diferente.

O senhor também pode usar ALTER ou COMMENT ON SQL comando.

Privacidade e segurança

Para perguntas frequentes sobre privacidade e segurança, consulte as perguntas frequentes sobre privacidade e segurança para recursos assistivos AI.