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:

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:

  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.

Requisitos de controle de acesso

Os usuários precisam de todos os itens a seguir para gerar descrições com 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;
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 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.