Générer des descriptions avec Snowflake Cortex¶

Vous pouvez utiliser l”Snowsight et la puissance de Snowflake Cortex pour générer automatiquement des descriptions pour une colonne, une table ou une vue. Snowflake Cortex exploite les modèles de langue de grande taille hébergés par Snowflake (LLMs) pour évaluer les métadonnées des objets et, le cas échéant, des échantillons de données afin de générer la description.

La description générée est enregistrée dans la propriété COMMENT de la colonne, de la table ou de la vue. Vous pouvez voir la description partout où la propriété COMMENT est affichée, qui comprend les éléments suivants :

Les onglets Table Details et View Details dans l”Snowsight.
L’onglet Columns pour la table ou la vue dans l”Snowsight.
La sortie d’une commande DESCRIBE TABLE.
La sortie de la vue TABLES Account Usage.

Un utilisateur disposant de tout privilège sur la table ou la vue, peut consulter la description de la table, de la vue ou de la colonne après que le propriétaire a généré la description.

Accéder à la fonction¶

Pour voir la fonction qui vous permet de générer des descriptions avec Snowflake Cortex, les deux conditions suivantes doivent être remplies :

Vous devez disposer des privilèges de contrôle d’accès requis.
Votre région doit prendre en charge le LLM utilisé par Snowflake Cortex pour générer les descriptions. Si vous disposez des privilèges requis, mais que vous ne voyez pas cette fonction, vérifiez la disponibilité de la fonction COMPLETE. Si la fonction COMPLETE n’est pas prise en charge dans votre région, vous devez activer l”inférence interrégionale pour utiliser la fonction.

Objets pris en charge¶

Vous pouvez générer des descriptions pour les objets suivants :

Table
Vue
Vue matérialisée
Les colonnes qui se trouvent dans les tables et les vues.

Créer et modifier des descriptions avec Snowflake Cortex¶

Les étapes permettant de générer et de modifier les descriptions alimentées par Snowflake Cortex pour les colonnes, les tables et les vues sont décrites dans les sous-sections suivantes.

Créer des descriptions pour les tables et les vues¶

Pour générer une description pour une table ou une vue, procédez comme suit :

Connectez-vous à l”Snowsight en tant qu’utilisateur ayant les privilèges requis.
Accédez à la table ou la vue pour laquelle vous souhaitez générer des descriptions.
Si vous y êtes invité, sélectionnez un entrepôt.
Dans l’onglet Table Details ou View Details, sélectionnez Generate with Cortex.
Si vous souhaitez modifier la description, sélectionnez l’icône en forme de crayon et modifiez la description.
Sélectionnez Save.

Créer des descriptions pour toutes les colonnes à la fois¶

L”Snowsight vous permet de générer des limites pour plusieurs colonnes à la fois, avec une limite de 50 colonnes à la fois. Pour générer des descriptions pour toutes les colonnes d’une table ou d’une vue en une seule action, procédez comme suit :

Connectez-vous à l”Snowsight en tant qu’utilisateur ayant les privilèges requis.
Accédez à la table ou la vue qui contient les colonnes.
Si vous y êtes invité, sélectionnez un entrepôt.
Sélectionnez l’onglet Columns.
Sélectionnez Generate Descriptions dans la barre d’outils.
Si vous y êtes invité, décidez d’utiliser ou non les données d’échantillon.
Si vous souhaitez modifier une description, sélectionnez l’icône en forme de crayon.
Sélectionnez les colonnes que vous souhaitez enregistrer.
Sélectionnez Save.
Si votre table ou votre vue comporte plus de 50 colonnes et que vous souhaitez générer des descriptions pour le reste des colonnes, répétez ce processus.

Créer des descriptions pour une seule colonne¶

Pour générer une description pour une seule colonne, procédez comme suit :

Connectez-vous à l”Snowsight en tant qu’utilisateur ayant les privilèges requis.
Accédez à la table ou la vue qui contient les colonnes.
Si vous y êtes invité, sélectionnez un entrepôt.
Sélectionnez l’onglet Columns.
Recherchez la colonne, passez la souris sur sa ligne dans la colonne Description, puis sélectionnez Generate with Cortex.
Si vous y êtes invité, décidez d’utiliser ou non les données d’échantillon.
Si vous souhaitez modifier la description, sélectionnez l’icône en forme de crayon.
Sélectionnez Save.

Remplacer les descriptions existantes¶

Pour remplacer une description spécifiée par l’utilisateur par une description générée, procédez comme suit :

Connectez-vous à l”Snowsight en tant qu’utilisateur ayant les privilèges requis.
Naviguez jusqu’à la table ou la vue dont vous souhaitez modifier les descriptions.
Sélectionnez un entrepôt s’il n’en existe pas déjà un.
Modifiez les descriptions des tables, des vues et des colonnes :
- Tables et vues : Dans l’onglet Table Details, sélectionnez l’icône du crayon pour modifier la description existante, puis sélectionnez Generate with Cortex.
- Colonnes : Dans l’onglet Columns, sélectionnez l’icône du crayon pour les descriptions existantes, puis sélectionnez Generate with Cortex.
Sélectionnez Save.

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

Les utilisateurs ont besoin de tous les éléments suivants pour générer des descriptions avec Snowflake Cortex :

Privilège OWNERSHIP sur la table ou la vue.
Le privilège USAGE sur un entrepôt.
Le rôle de la base de données SNOWFLAKE.CORTEX_USER pour utiliser Snowflake Cortex.

Par exemple, l’administrateur de compte peut exécuter ce qui suit pour permettre aux utilisateurs ayant le rôle table_owner_role de générer des descriptions pour leurs tables :

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

Entrées de données d’échantillon¶

Lorsque vous générez une description pour une colonne, vous pouvez vous baser uniquement sur les métadonnées, ou vous pouvez choisir d’utiliser des échantillons de données pour améliorer la description alimentée par le Snowflake Cortex. Les données d’échantillon font référence aux données d’une colonne particulière qui sont évaluées lorsque vous utilisez Snowflake Cortex pour générer des descriptions. Si vous choisissez d’utiliser des données d’échantillon, Snowflake utilise une partie des données d’échantillon pour générer la description, ce qui permet d’obtenir des descriptions plus précises. Les données d’échantillon ne sont pas stockées par Snowflake en tant que données d’utilisation.

La décision d’utiliser des données d’échantillon est propre à chaque utilisateur. La première fois que vous générez une description de colonne dans une session du navigateur, vous êtes invité à décider si vous voulez utiliser des données d’échantillon. La fenêtre contextuelle indique par défaut oui et vous permet de choisir de désactiver les données d’échantillon avant de poursuivre. Votre navigateur enregistre votre réponse à cette question pour la durée de votre session Snowflake et la question ne vous sera pas posée à nouveau avant votre prochaine session. Vous pouvez également utiliser votre profil d’utilisateur pour établir votre paramètre de préférence quant à l’utilisation des données d’échantillon.

Note

Les données d’échantillon peuvent traverser les frontières régionales si la région prend en charge Snowflake Cortex. Pour plus d’informations, voir Accéder à la fonction.

Considérations relatives aux clients¶

La production de descriptions entraîne les coûts suivants :

Crédits consommés par l’entrepôt en service.
Frais de crédit pour l’utilisation de Snowflake Cortex avec des LLMs plus petits comme Mistral-7b et Llama 3.1-8b. Ces frais sont facturés sous la forme de Services AI, ce qui inclut toutes les utilisations de Snowflake Cortex.

Avis juridiques¶

La classification des données d’entrées et de sorties est présentée dans la table suivante.

Classification des données d’entrée	Classification des données de sortie	Désignation
Usage Data	Usage Data	Covered AI Features [1]

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