Adicionar comentários gerados pelo site AIaos objetos Unity Catalog

Este artigo apresenta os comentários AI Unity Catalog de colunas de objetos e AItabelas gerados pelo site(também conhecidos como documentação gerada pelo site), explica como eles funcionam e mostra como adicioná-los e editá-los.

important

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

Para obter detalhes sobre o AI por trás dos comentários gerados pelo AI, consulte Databricks AI recurso trust and safety.

Objetos suportados

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

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

AI-Os comentários gerados não são compatíveis com a visualização ou com a visualização materializada.

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.

important

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 comentários depois de adicionados, o senhor deve ter o privilégio SELECT no objeto, USE SCHEMA no esquema pai e USE CATALOG no catálogo pai.

Para obter informações sobre os modelos que são usados para gerar sugestões de comentários, consulte as Perguntas frequentes.

Antes de começar

Para que o senhor possa usar os comentários gerados pelo AI, o seu workspace deve estar habilitado para o recurso de assistência AI. Na maioria dos espaços de trabalho, isso é ativado pelo site default. No entanto, se o seu workspace usar o perfil de segurançacompliance, um administrador do workspace deverá habilitar o recurso assistivo AI com parceiros:

1. Em Settings (Configurações ), acesse Advanced tab e role para baixo até a seção Other (Outros ).
2. Ative a opção de recurso assistivo do AI alimentado por parceiros .

important

Somente para tabelas e colunas, os comentários AI funcionam por default e não são controlados por recurso assistivo AI acionado por parceiros . Para obter detalhes, consulte o recurso regido pela configuração de recurso assistivo do AI, alimentado por parceiros.

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 : O senhor deve ser o proprietário do objeto ou ter o privilégio MODIFY no objeto para view o comentário AI-suggested, editá-lo e adicioná-lo.

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 títulos das colunas da tabela, clique em AI generate (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 fechá-lo sem ser salvo.

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.

Perguntas frequentes sobre AI- comentários gerados para objetos Unity Catalog

Esta seção fornece informações gerais sobre os comentários gerados pelo AI(também conhecidos como documentação gerada pelo AI) para os objetos Unity Catalog na forma de perguntas frequentes.

Qual é o serviço usado pelo recurso de comentários gerados pelo site AI?

AIOs comentários gerados (também conhecidos como AI-generated documentation) para tabelas e colunas de tabelas usam o serviço Azure OpenAI se o recurso de parceiros AI estiver ativado. Se o senhor desativar o AIalimentado por parceiros , os comentários do AI usarão um modelo hospedado pelo Databricks.

Para obter mais detalhes, incluindo os modelos usados para outros comentários gerados pelo site AI, consulte recurso governado pela configuração de recurso assistivo do site AI, alimentado por parceiros.

Em quais regiões o servindo modelo endpoint está hospedado?

Os dados da União Europeia (UE) permanecem na UE. Para modelos de parceiros externos, o espaço de trabalho da União Europeia (UE) usa um modelo externo hospedado na UE. Todas as outras regiões usam um modelo externo hospedado nos EUA.

Quais dados são enviados para os modelos?

A Databricks envia os seguintes metadados para os modelos com cada solicitação de API:

• Catálogo (nome do catálogo, comentário atual, tipo de catálogo)
• Esquema (nome do catálogo, nome do esquema, comentário atual)
• Tabela (nome do catálogo, nome do esquema, nome da tabela, comentário atual)
• Função (nome do catálogo, nome do esquema, nome da função, comentário atual, parâmetros, definição)
• Modelo (nome do catálogo, nome do esquema, nome do modelo, comentário atual, aliases)
• Volume (nome do catálogo, nome do esquema, nome do volume, comentário atual)
• Nomes de colunas (nome da coluna, tipo, primária key ou não, comentário da coluna atual)

Os comentários aprovados são armazenados no banco de dados do plano de controle do Databricks, juntamente com o restante dos metadados do Unity Catalog. O banco de dados do plano de controle é criptografado em AES de 256 bits.