Gerar descrições com o Snowflake Cortex

Você pode usar a Snowsight e o poder da função Snowflake Cortex COMPLETE para gerar automaticamente descrições para uma coluna, tabela ou exibição. O recurso Cortex Powered Object Descriptions usa os modelos de linguagem de grande escala hospedados no Snowflake (LLMs) para avaliar os metadados do objeto e, se desejado, os dados de amostra para gerar a descrição.

A descrição gerada, uma vez salva, é preservada 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, exibição ou coluna pode visualizar a descrição depois que ela for salva.

Nota

Você também pode chamar um procedimento armazenado para gerar programaticamente descrições de objetos usando o Snowflake Cortex. Para obter mais informações, consulte Uso de SQL para gerar automaticamente descrições de objetos.

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:

Objetos com suporte

É possível gerar descrições para os seguintes objetos:

  • Todos os tipos de tabela

  • Exibições

  • Exibições materializadas

  • Colunas que estão em tabelas e exibições.

Criar, editar e salvar descrições com o Snowflake Cortex

As etapas para gerar e editar Snowflake Cortex Powered Descriptions estão nas subseções a seguir.

Gerar e salvar descrições

Para gerar e salvar uma descrição para uma tabela ou exibição, faça o seguinte:

  1. Faça login no Snowsight como um usuário com os privilégios necessários.

  2. Navegue até a tabela ou exibição para a qual deseja gerar descrições.

  3. Se solicitado, selecione um warehouse.

  4. Na guia Table Details ou View Details, selecione Generate with Cortex.

  5. Se você quiser editar a descrição, selecione o ícone de lápis e edite a descrição.

  6. 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:

  1. Faça login no Snowsight como um usuário com os privilégios necessários.

  2. Navegue até a tabela ou exibição que contém as colunas.

  3. Se solicitado, selecione um warehouse.

  4. Selecione a guia Columns.

  5. Selecione Generate Descriptions na barra de ferramentas.

  6. Se solicitado, decida se deseja usar os dados de amostra.

  7. Se quiser editar uma descrição, selecione o ícone de lápis.

  8. Selecione as colunas que deseja salvar.

  9. Selecione Save.

  10. 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:

  1. Faça login no Snowsight como um usuário com os privilégios necessários.

  2. Navegue até a tabela ou exibição que contém as colunas.

  3. Se solicitado, selecione um warehouse.

  4. Selecione a guia Columns.

  5. Localize a coluna, passe o mouse sobre sua linha na coluna Description e, em seguida, selecione Generate with Cortex.

  6. Se solicitado, decida se deseja usar os dados de amostra.

  7. Se quiser editar a descrição, selecione o ícone de lápis.

  8. 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:

  1. Faça login no Snowsight como um usuário com os privilégios necessários.

  2. Navegue até a tabela ou exibição para a qual deseja editar as descrições.

  3. Selecione um warehouse se ainda não estiver em uso.

  4. 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.

  5. Selecione Save.

Gerar descrições sem salvar

Para gerar uma descrição de uma tabela ou exibição, faça o seguinte:

  1. Faça login no Snowsight como um usuário com os privilégios necessários.

  2. Navegue até a tabela ou exibição para a qual deseja gerar descrições.

  3. Se solicitado, selecione um warehouse.

  4. Na guia Table Details ou View Details, selecione Describe Table.

Nota

O proprietário da tabela não pode salvar as descrições geradas selecionando o botão Describe Table. Se você for o proprietário de uma tabela e desejar editar e salvar descrições, selecione Generate with Cortex na seção Description da página.

Requisitos de controle de acesso

Os usuários precisam de todos os seguintes itens para usar o recurso Descrições de objetos com tecnologia Cortex:

  • O privilégio USAGE em um warehouse.

  • A função de banco de dados SNOWFLAKE.CORTEX_USER para usar o Snowflake Cortex.

  • Um dos seguintes:

    • Para gerar, mas não salvar, descrições em nível de objeto, o privilégio SELECT no objeto.

    • Para gerar e salvar descrições para objetos e colunas, o privilégio OWNERSHIP no objeto.

Por exemplo, o administrador da conta pode executar o seguinte para permitir que usuários com a função my_role gerem descrições:

USE ROLE ACCOUNTADMIN;
GRANT USAGE ON WAREHOUSE ai_wh TO ROLE my_role;
GRANT DATABASE ROLE SNOWFLAKE.CORTEX_USER TO ROLE my_role;
Copy

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 pelo 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.