Gerar descrições com o Snowflake Cortex¶
É possível usar o Snowsight e o poder do Snowflake Cortex para gerar automaticamente descrições para uma coluna, tabela ou exibição. O Snowflake Cortex utiliza os grandes modelos de linguagem (LLMs) hospedados no Snowflake para avaliar os metadados do objeto e, se desejado, os dados de amostra para gerar a descrição.
A descrição gerada é salva na propriedade COMMENT
da coluna, tabela ou exibição. É possível visualizar a descrição em qualquer lugar em que a propriedade COMMENT
for exibida, o que inclui o seguinte:
As guias Table Details e View Details em Snowsight.
A guia Columns para a tabela ou exibição no Snowsight.
A saída de um comando DESCRIBE TABLE.
A saída da exibição Account Usage TABLES.
Um usuário com qualquer privilégio na tabela ou exibição pode visualizar a descrição da tabela, exibição ou coluna depois que o proprietário gerar a descrição.
Como acessar o recurso¶
Para ver o recurso que permite que você gere descrições com o Snowflake Cortex, ambos os itens a seguir devem ser verdadeiros:
É necessário ter os privilégios de controle de acesso necessários.
Sua região deve ser compatível com o LLM usado pelo Snowflake Cortex para gerar as descrições. Se você tiver os privilégios necessários, mas não vir esse recurso, verifique a disponibilidade da função COMPLETE. Se a função COMPLETE não for compatível com a sua região, você precisará ativar a inferência entre regiões para usar o recurso.
Objetos com suporte¶
É possível gerar descrições para os seguintes objetos:
Tabela
Exibição
Exibição materializada
Colunas que estão em tabelas e exibições.
Criação e edição de descrições com o Snowflake Cortex¶
As etapas para gerar e editar as Descrições com tecnologia Snowflake Cortex para colunas, tabelas e exibições estão nas subseções a seguir.
Criação de descrições para tabelas e exibições¶
Para gerar uma descrição para uma tabela ou exibição, faça o seguinte:
Faça login no Snowsight como um usuário com os privilégios necessários.
Navegue até a tabela ou exibição para a qual deseja gerar descrições.
Se solicitado, selecione um warehouse.
Na guia Table Details ou View Details, selecione Generate with Cortex.
Se você quiser editar a descrição, selecione o ícone de lápis e edite a descrição.
Selecione Save.
Criação de descrições para todas as colunas de uma só vez¶
Snowsight permite que você gere descrições para várias colunas de uma só vez, com um limite de 50 colunas por vez. Para gerar descrições para todas as colunas em uma tabela ou exibição com uma única ação, faça o seguinte:
Faça login no Snowsight como um usuário com os privilégios necessários.
Navegue até a tabela ou exibição que contém as colunas.
Se solicitado, selecione um warehouse.
Selecione a guia Columns.
Selecione Generate Descriptions na barra de ferramentas.
Se solicitado, decida se deseja usar os dados de amostra.
Se quiser editar uma descrição, selecione o ícone de lápis.
Selecione as colunas que deseja salvar.
Selecione Save.
Se sua tabela ou exibição tiver mais de 50 colunas e você quiser gerar descrições para o restante das colunas, repita esse processo.
Criação de descrições para uma única coluna¶
Para gerar uma descrição para uma única coluna, faça o seguinte:
Faça login no Snowsight como um usuário com os privilégios necessários.
Navegue até a tabela ou exibição que contém as colunas.
Se solicitado, selecione um warehouse.
Selecione a guia Columns.
Localize a coluna, passe o mouse sobre sua linha na coluna Description e, em seguida, selecione Generate with Cortex.
Se solicitado, decida se deseja usar os dados de amostra.
Se quiser editar a descrição, selecione o ícone de lápis.
Selecione Save.
Substituição das descrições existentes¶
Para substituir uma descrição especificada pelo usuário por uma descrição gerada, faça o seguinte:
Faça login no Snowsight como um usuário com os privilégios necessários.
Navegue até a tabela ou exibição para a qual deseja editar as descrições.
Selecione um warehouse se ainda não estiver em uso.
Edite as descrições de tabelas, exibições e colunas:
Tabelas e exibições: na guia Table Details, selecione o ícone de lápis para editar a descrição existente e selecione Generate with Cortex.
Colunas: na guia Columns, selecione o ícone de lápis para as descrições existentes e selecione Generate with Cortex.
Selecione Save.
Requisitos de controle de acesso¶
Os usuários precisam de todos os itens a seguir para gerar descrições com o Snowflake Cortex:
O privilégio OWNERSHIP na tabela ou exibição.
O privilégio USAGE em um warehouse.
A função de banco de dados SNOWFLAKE.CORTEX_USER para usar o Snowflake Cortex.
Por exemplo, o administrador de conta pode executar o seguinte para permitir que os usuários com a função table_owner_role
gerem descrições para suas tabelas:
USE ROLE ACCOUNTADMIN;
GRANT USAGE ON WAREHOUSE ai_wh TO ROLE table_owner_role;
GRANT DATABASE ROLE SNOWFLAKE.CORTEX_USER TO ROLE table_owner_role;
Entradas de dados de amostra¶
Ao gerar uma descrição para uma coluna, é possível se basear apenas em metadados ou optar por usar dados de amostra para melhorar a descrição alimentada pelo Snowflake Cortex. Os dados de amostra referem-se aos dados de uma coluna específica que é avaliada quando você usa o Snowflake Cortex para gerar descrições. Se optar por usar dados de amostra, o Snowflake usará uma parte dos dados de amostra para gerar a descrição, o que resulta em descrições mais precisas. Os dados de amostra não são armazenados pela Snowflake como dados de uso.
A decisão de usar dados de amostra é específica do usuário individual. Na primeira vez que você gerar uma descrição de coluna em uma sessão do navegador, será solicitado a decidir se deseja usar dados de amostra. O padrão da caixa pop-up é sim e permite que você opte por desativar os dados de amostra antes de continuar. O navegador armazena a resposta a essa pergunta enquanto durar a sessão do Snowflake e a pergunta não será feita novamente até a próxima sessão. Você também pode usar o perfil de usuário para definir sua preferência quanto ao uso de dados de amostra.
Nota
Os dados de amostra podem ultrapassar as fronteiras regionais se a região for compatível com o Snowflake Cortex. Para obter mais informações, consulte Como acessar o recurso.
Considerações sobre custo¶
A geração de descrições incorre nos seguintes custos:
Créditos consumidos pelo warehouse em uso.
Créditos cobrados pelo uso do Snowflake Cortex com LLMs menores, como Mistral-7b e Llama 3.1-8b. Essas cobranças aparecem em uma fatura como AI-Services, incluindo todos os usos do Snowflake Cortex.
Avisos legais¶
A classificação dos dados de entradas e saídas é definido na tabela a seguir.
Classificação de dados de entrada |
Classificação de dados de saída |
Designação |
---|---|---|
Usage Data |
Usage Data |
Covered AI Features [1] |
Para obter informações adicionais, consulte AI e ML Snowflake.