Uso do Snowflake Copilot em linha¶

Requisitos de controle de acesso¶

A função do banco de dados COPILOT_USER no banco de dados SNOWFLAKE inclui os privilégios que permitem aos usuários usar recursos Snowflake Copilot. Por padrão, a função COPILOT_USER é concedida à função PUBLIC. A função PUBLIC é concedida automaticamente a todos os usuários e funções, permitindo que todos os usuários da sua conta usem os recursos Snowflake Copilot.

Além do requisito COPILOT_USER, os usuários devem ter a função CORTEX_USER. A função de banco de dados CORTEX_USER no banco de dados SNOWFLAKE inclui os privilégios que permitem aos usuários chamar as funções AISQL Snowflake. Por padrão, a função CORTEX_USER é concedida à função PUBLIC. A função PUBLIC é concedida automaticamente a todos os usuários e funções, portanto, isso permite que todos os usuários de sua conta usem as funções AISQL Snowflake.

O Snowflake Copilot em linha exige que o usuário tenha acesso ao modelo claude-3.5-sonnet. Para garantir que todos os usuários tenham acesso a esse modelo, certifique-se de que claude-3.5-sonnet esteja incluído na lista de permissões do modelo e não esteja limitado pelo controle de acesso baseado em função (RBAC). Para obter mais informações sobre o controle de acesso ao modelo, consulte Controle o acesso ao modelo.

Se os usuários tiverem as permissões corretas, eles verão o ícone de raio em linha Snowflake Copilot nos espaços de trabalho. Eles podem usar a interface em linha para interagir com o Snowflake Copilot.

Para remover o acesso ao Copilot em linha, você deve revogar o acesso a CORTEX_USER ou COPILOT_USER. Se não quiser que todos os usuários tenham esse privilégio, você pode revogar o acesso à função PUBLIC e conceder acesso às funções específicas. Por exemplo, para revogar o acesso da função PUBLIC, use a seguinte consulta:

USE ROLE ACCOUNTADMIN;

REVOKE DATABASE ROLE SNOWFLAKE.COPILOT_USER
  FROM ROLE PUBLIC;

REVOKE DATABASE ROLE SNOWFLAKE.CORTEX_USER
  FROM ROLE PUBLIC;

Você pode conceder acesso conforme necessário. Para obter informações sobre como limitar o acesso ao Snowflake Copilot, consulte Limitar acesso ao Copilot.

Casos de uso compatíveis¶

• Explore seus dados fazendo perguntas abertas para aprender sobre a estrutura e as nuances de um novo conjunto de dados.

• Gere consultas SQL com perguntas em linguagem natural.

• Melhore suas consultas pedindo ao Snowflake Copilot para ajudar você a avaliar a eficiência da consulta, encontrar otimizações ou explicar o que a consulta faz.

• Corrija os erros de sintaxe solicitando a Snowflake Copilot que corrija sua consulta.

Limitações¶

O Snowflake Copilot em linha tem as seguintes limitações:

• Suporte aos seguintes idiomas:

  • Inglês

  • Francês

  • Alemão

  • Espanhol

  • Italiano

  • Português

  • Árabe

  • Hindi

  • Chinês

  • Japonês

  • Coreano

  • SQL

Sem acesso aos seus dados

O Snowflake Copilot não tem acesso aos dados dentro de suas tabelas. Se quiser filtrar um valor específico de uma coluna, você deverá fornecer esse valor. Por exemplo, se você pedir ao Snowflake Copilot para retornar todas as linhas com um valor de coluna A igual a “X”, você deve fornecer o valor “X” em sua solicitação. Para obter mais informações, consulte o exemplo Como criar e executar uma instrução SQL.

Resposta atrasada

O Snowflake Copilot pode levar um segundo para concluir uma resposta, dependendo do tamanho da resposta fornecida.

As sugestões SQL podem nem sempre funcionar

O Snowflake Copilot pode, às vezes, sugerir consultas que contenham sintaxe SQL inválida ou tabelas ou colunas inexistentes.

Atraso na detecção de novos bancos de dados, esquemas e tabelas

Pode levar de 3 a 4 horas para que o Snowflake Copilot reconheça bancos de dados, esquemas e tabelas recém-criados.

Número limitado de tabelas e colunas consideradas

Para gerar uma resposta, o Snowflake Copilot primeiro procura as tabelas e colunas mais relevantes para sua solicitação. Os resultados da pesquisa são então classificados por relevância e apenas as 10 principais tabelas e as 10 principais colunas de cada uma dessas tabelas nos resultados são consideradas ao gerar uma resposta.

O Snowflake Copilot em linha não oferece suporte a feedback

Você não pode votar a favor ou contra as sugestões que o Snowflake Copilot em linha lhe oferece.

Como usar o Snowflake Copilot em linha¶

O Snowflake Copilot em linha não requer nenhuma configuração adicional. Lembre-se dos seguintes pontos ao usar o Snowflake Copilot:

• Cada sessão com o Snowflake Copilot em linha está associada a um arquivo específico em seu espaço de trabalho.

• Você não precisa ter um banco de dados e um esquema em uso durante a sessão para usar o Snowflake Copilot em linha.

• O Snowflake Copilot usa os nomes de seus bancos de dados, esquemas, tabelas e colunas, além dos tipos de dados de suas colunas, para determinar quais dados estão disponíveis para consulta.

• Para um desempenho ideal, use nomes significativos para bancos de dados, esquemas, tabelas e colunas e garanta que as colunas tenham o tipo de dados apropriado atribuído.

• O Snowflake Copilot em linha considera as seguintes fontes, mas não armazena os dados delas:

  • Conteúdo do arquivo atual, incluindo consultas e código SQL.

  • Contexto do arquivo atual, incluindo banco de dados, esquema e função.

  • Entrada fornecida pelo usuário.

  • Documentação do Snowflake ou conhecimento geral de SQL.

  • Dados de sua conta.

Para começar a usar o Snowflake Copilot em linha:

1. Abra um espaço de trabalho. Para obter informações sobre os espaços de trabalho, consulte Espaços de trabalho.

2. Digite o atalho CMD+I.

3. Na caixa de diálogo da mensagem, digite sua solicitação. Em seguida, clique no ícone de enviar para enviá-la. O Snowflake Copilot fornece uma resposta em linha e mostra uma comparação com o código existente.

4. Escolha uma das seguintes opções:

   • Selecione Accept para aceitar as alterações sugeridas.

   • Selecione Reject para rejeitar as alterações sugeridas.

   • Selecione Close para encerrar a sessão.

Como adicionar instruções personalizadas¶

O Snowflake Copilot em linha não aceita instruções personalizadas para personalizar a forma como ele responde.

Exemplos¶

As seções a seguir fornecem exemplos que demonstram como:

• Construir e executar instruções SQL

• Adicione comentários a uma instrução SQL

• Corrija uma instrução SQL

Esses exemplos usam um conjunto de dados de amostra do Snowflake Marketplace.

Dicas para usar o Snowflake Copilot¶

Para obter dicas sobre como usar o Snowflake Copilot, consulte Dicas para usar o Snowflake Copilot.

Custos¶

O Snowflake Copilot atualmente é gratuito para uso. Detalhes sobre preço e faturamento estão planejados, mas você será notificado antes que quaisquer cobranças sejam aplicadas a esse recurso.

Avisos legais¶

Esse recurso utiliza modelos e/ou serviços de terceiros, conforme descrito anteriormente nesta página. Quando os modelos e/ou serviços usados são fornecidos na página Termos complementares de modelos e serviços Snowflake, o uso desses modelos e/ou serviços também está sujeito a esses termos.

Para obter informações adicionais, consulte AI e ML Snowflake.