Utilisation de Snowflake Copilot en ligne¶

Exigences en matière de contrôle d’accès¶

Le rôle de base de données COPILOT_USER dans la base de données SNOWFLAKE comprend les privilèges qui permettent aux utilisateurs d’utiliser les fonctions Snowflake Copilot. Par défaut, le rôle COPILOT_USER est accordé au rôle PUBLIC. Le rôle PUBLIC est automatiquement accordé à tous les utilisateurs et rôles, de façon à permettre à tous les utilisateurs de votre compte d’utiliser les fonctions Snowflake Copilot.

En plus de l’exigence COPILOT_USER, les utilisateurs doivent avoir le rôle CORTEX_USER. Le rôle de base de données CORTEX_USER dans la base de données SNOWFLAKE comprend les privilèges qui permettent aux utilisateurs d’appeler les fonctions AISQL de Snowflake. Par défaut, le rôle CORTEX_USER est accordé au rôle PUBLIC. Le rôle PUBLIC est automatiquement accordé à tous les utilisateurs et rôles, ce qui permet à tous les utilisateurs de votre compte d’utiliser les fonctions AISQL de Snowflake.

Snowflake Copilot en ligne exige que l’utilisateur ait accès au modèle claude-3.5-sonnet. Pour vérifier que tous les utilisateurs ont accès à ce modèle, assurez-vous que claude-3.5-sonnet est inclus dans la liste d’autorisations du modèle et qu’il n’est pas limité par le contrôle d’accès basé sur les rôles (RBAC). Pour plus d’informations sur le contrôle d’accès aux modèles, voir Contrôle de l’accès au modèle.

Si les utilisateurs disposent des autorisations adéquates, ils voient apparaître l’icône d’étincelle de Snowflake Copilot en ligne dans Workspaces. Ils peuvent utiliser l’interface en ligne pour interagir avec Snowflake Copilot.

Pour supprimer l’accès à Copilot en ligne, vous devez révoquer l’accès à CORTEX_USER ou COPILOT_USER. Si vous ne souhaitez pas que tous les utilisateurs disposent de ce privilège, vous pouvez révoquer l’accès au rôle PUBLIC et accorder l’accès à des rôles spécifiques. Par exemple, pour révoquer l’accès du rôle PUBLIC, utilisez la requête suivante :

USE ROLE ACCOUNTADMIN;

REVOKE DATABASE ROLE SNOWFLAKE.COPILOT_USER
  FROM ROLE PUBLIC;

REVOKE DATABASE ROLE SNOWFLAKE.CORTEX_USER
  FROM ROLE PUBLIC;

Vous pouvez ensuite accorder l’accès en fonction des besoins. Pour des informations sur la limitation de l’accès à Snowflake Copilot, voir Limitation de l’accès à Copilot.

Cas d’utilisation pris en charge¶

• Explorez vos données en posant des questions ouvertes pour connaître la structure et les nuances d’un nouvel ensemble de données.

• Générer des requêtes SQL avec des questions en langue naturelle.

• Améliorez vos requêtes en demandant à Snowflake Copilot de vous aider à évaluer l’efficacité de la requête, à trouver des optimisations ou à expliquer ce que fait la requête.

• Corriger les erreurs de syntaxe en demandant à Snowflake Copilot de corriger votre requête.

Limitations¶

Snowflake Copilot en ligne présente les limitations suivantes :

• Prise en charge des langues suivantes :

  • Anglais

  • Français

  • Allemand

  • Espagnol

  • Italien

  • Portugais

  • Arabe

  • Hindi

  • Chinois

  • Japonais

  • Coréen

  • SQL

Pas d’accès à vos données

Snowflake Copilot n’a pas accès aux données contenues dans vos tables. Si vous souhaitez filtrer sur une valeur particulière d’une colonne, vous devez fournir cette valeur. Par exemple, si vous demandez à Snowflake Copilot de renvoyer toutes les lignes dont la valeur de la colonne A est égale à « X », vous devez fournir la valeur « X » dans votre requête. Pour plus d’informations, consultez l’exemple Construire et exécuter une instruction SQL.

Réponse différée

Snowflake Copilot peut prendre une seconde pour compléter une réponse, en fonction de la longueur de la réponse fournie.

Les suggestions SQL ne fonctionnent pas toujours

Snowflake Copilot peut parfois suggérer des requêtes contenant une syntaxe SQL non valide ou des tables ou colonnes inexistantes.

Retard dans la détection de nouvelles bases de données, de nouveaux schémas et de nouvelles tables

La reconnaissance par Snowflake Copilot des bases de données, schémas et tables nouvellement créés peut prendre jusqu’à 3 ou 4 heures.

Nombre limité de tables et de colonnes prises en compte

Pour générer une réponse, Snowflake Copilot recherche d’abord les tables et les colonnes les plus pertinentes pour votre requête. Les résultats de la recherche sont ensuite classés par ordre de pertinence et seuls les 10 premières tables et les 10 premières colonnes de chacune de ces tables dans les résultats sont pris en compte lors de la génération d’une réponse.

Snowflake Copilot en ligne ne prend pas en charge le retour d’information

Vous ne pouvez pas noter à la hausse ou à la baisse les suggestions que Snowflake Copilot en ligne vous donne.

Comment utiliser Snowflake Copilot en ligne¶

Snowflake Copilot en ligne ne nécessite aucune configuration supplémentaire. N’oubliez pas les points suivants lorsque vous utilisez Snowflake Copilot :

• Chaque session avec Snowflake Copilot en ligne est associée à un fichier particulier dans votre Workspace.

• Il n’est pas nécessaire d’avoir une base de données et un schéma en cours d’utilisation pendant votre session pour utiliser Snowflake Copilot en ligne.

• Snowflake Copilot utilise les noms de vos bases de données, schémas, tables et colonnes ainsi que les types de données de vos colonnes pour déterminer les données disponibles pour la requête.

• Pour des performances optimales, utilisez des noms significatifs pour les bases de données, les schémas, les tables et les colonnes et veillez à ce que le type de données approprié soit attribué aux colonnes.

• Snowflake Copilot en ligne prend en compte les sources suivantes, mais ne stocke pas les données qu’elles contiennent :

  • Contenu du fichier actuel, y compris le code et les requêtes SQL.

  • Contexte du fichier actuel, y compris la base de données, le schéma et le rôle.

  • Entrée fournie par l’utilisateur.

  • Documentation sur Snowflake ou connaissances générales sur SQL.

  • Données de votre compte.

Pour commencer à utiliser Snowflake Copilot en ligne :

1. Ouvrez un Workspace. Pour plus d’informations sur Workspaces, voir Espaces de travail.

2. Entrez le raccourci CMD+I.

3. Dans la boîte de dialogue du message, saisissez votre requête. Cliquez ensuite sur l’icône d’envoi pour la soumettre. Snowflake Copilot fournit une réponse en ligne et affiche une différence avec le code existant.

4. Choisissez l’une des options suivantes :

   • Sélectionnez Accept pour accepter les modifications proposées.

   • Sélectionnez Reject pour rejeter les modifications proposées.

   • Sélectionnez Close pour mettre fin à la session.

Ajouter des instructions personnalisées¶

Snowflake Copilot en ligne n’accepte pas d’instructions personnalisées pour adapter sa réponse.

Exemples¶

Les sections suivantes fournissent des exemples qui démontrent comment :

• Construire et exécuter des instructions SQL

• Ajouter des commentaires à une instruction SQL

• Corriger une instruction SQL

Ces exemples utilisent un ensemble de données d’échantillon provenant de Snowflake Marketplace.

Conseils d’utilisation Snowflake Copilot¶

Pour obtenir des conseils sur l’utilisation de Snowflake Copilot, voir Conseils d’utilisation Snowflake Copilot.

Coûts¶

Snowflake Copilot est actuellement gratuit. Des informations sur les tarifs et la facturation sont prévues. Vous serez averti avant que des frais ne soient appliqués pour cette fonctionnalité.

Avis juridiques¶

Cette fonction s’appuie sur des modèles et/ou des services de tiers, comme décrit précédemment sur cette page. Lorsque les modèles et/ou les services utilisés sont fournis sur la page Modèle Snowflake et conditions d’intégration de service, l’utilisation de ces modèles et/ou services est également soumise à ces conditions.

Pour plus d’informations, reportez-vous à Snowflake AI et ML.