Beschreibungen mit Snowflake Cortex erzeugen¶
Sie können Snowsight und die Leistungsfähigkeit von Snowflake Cortex nutzen, um automatisch Beschreibungen für eine Spalte, Tabelle oder Ansicht zu erstellen. Snowflake Cortex nutzt die in Snowflake gehosteten großen Sprachmodelle (LLMs), um Objekt-Metadaten und, falls gewünscht, Beispieldaten auszuwerten und die Beschreibung zu erstellen.
Die generierte Beschreibung wird in der Eigenschaft COMMENT
der Spalte, Tabelle oder Ansicht gespeichert. Sie können die Beschreibung überall dort einsehen, wo die Eigenschaft COMMENT
angezeigt wird, die Folgendes enthält:
Die Registerkarten Table Details und View Details in Snowsight.
Die Registerkarte Columns für die Tabelle oder Ansicht in Snowsight.
Die Ausgabe eines DESCRIBE TABLE-Befehls.
Die Ausgabe der Ansicht Account Usage TABLES.
Ein Benutzer mit jeder Berechtigung für die Tabelle oder Ansicht kann die Beschreibung der Tabelle, der Ansicht oder der Spalte anzeigen, nachdem der Eigentümer die Beschreibung erstellt hat.
Zugriff auf das Feature¶
Um das Feature anzuzeigen, mit dem Sie Beschreibungen mit Snowflake Cortex erstellen können, müssen beide der folgenden Bedingungen erfüllt sein:
Sie müssen über die erforderlichen Zugriffssteuerungsrechte verfügen.
Ihre Region muss die LLM unterstützen, die von Snowflake Cortex zur Erstellung der Beschreibungen verwendet wird. Wenn Sie über die erforderlichen Berechtigungen verfügen, dieses Feature aber nicht sehen, überprüfen Sie die Verfügbarkeit der Funktion COMPLETE. Wenn die Funktion COMPLETE in Ihrer Region nicht unterstützt wird, müssen Sie die regionenübergreifende Inferenz aktivieren, um das Feature nutzen zu können.
Unterstützte Objekte¶
Sie können Beschreibungen für die folgenden Objekte erstellen:
Tabelle
Ansicht
Materialisierte Ansicht
Spalten, die sich in Tabellen und Ansichten befinden.
Erstellen und bearbeiten Sie Beschreibungen mit Snowflake Cortex¶
Die Schritte zum Erstellen und Bearbeiten von Snowflake Cortex-gesteuerte Beschreibungen für Spalten, Tabellen und Ansichten finden Sie in den folgenden Unterabschnitten.
Beschreibungen für Tabellen und Ansichten erstellen¶
Um eine Beschreibung für eine Tabelle oder Ansicht zu erstellen, gehen Sie wie folgt vor:
Melden Sie sich bei Snowsight als Benutzer mit den erforderlichen Berechtigungen an.
Navigieren Sie zu der Tabelle oder Ansicht, für die Sie Beschreibungen erstellen möchten.
Wenn Sie bei Aufforderung ein Warehouse aus.
Wählen Sie auf der Registerkarte Table Details oder View Details die Registerkarte Generate with Cortex.
Wenn Sie die Beschreibung bearbeiten möchten, wählen Sie das Bleistiftsymbol und bearbeiten Sie die Beschreibung.
Wählen Sie Save aus.
Beschreibungen für alle Spalten auf einmal erstellen¶
Snowsight ermöglicht es Ihnen, Beschreibungen für mehrere Spalten auf einmal zu erstellen, wobei die Anzahl der Spalten auf 50 begrenzt ist. Um mit einer einzigen Aktion Beschreibungen für alle Spalten in einer Tabelle oder Ansicht zu erzeugen, gehen Sie wie folgt vor:
Melden Sie sich bei Snowsight als Benutzer mit den erforderlichen Berechtigungen an.
Navigieren Sie zu der Tabelle oder Ansicht, die die Spalten enthält.
Wenn Sie bei Aufforderung ein Warehouse aus.
Wählen Sie die Registerkarte Columns aus.
Wählen Sie Generate Descriptions in der Symbolleiste.
Wenn Sie dazu aufgefordert werden, entscheiden Sie, ob Sie Beispieldaten verwenden möchten.
Wenn Sie eine Beschreibung bearbeiten möchten, wählen Sie das Bleistiftsymbol.
Wählen Sie die Spalten aus, die Sie speichern möchten.
Wählen Sie Save aus.
Wenn Ihre Tabelle oder Ansicht mehr als 50 Spalten hat und Sie Beschreibungen für die restlichen Spalten erstellen möchten, wiederholen Sie diesen Vorgang.
Beschreibungen für eine einzelne Spalte erstellen¶
Um eine Beschreibung für eine einzelne Spalte zu erstellen, gehen Sie wie folgt vor:
Melden Sie sich bei Snowsight als Benutzer mit den erforderlichen Berechtigungen an.
Navigieren Sie zu der Tabelle oder Ansicht, die die Spalten enthält.
Wenn Sie bei Aufforderung ein Warehouse aus.
Wählen Sie die Registerkarte Columns aus.
Suchen Sie die Spalte, bewegen Sie den Mauszeiger über ihre Zeile in der Spalte Description, und wählen Sie Generate with Cortex.
Wenn Sie dazu aufgefordert werden, entscheiden Sie, ob Sie Beispieldaten verwenden möchten.
Wenn Sie die Beschreibung bearbeiten möchten, wählen Sie das Bleistiftsymbol.
Wählen Sie Save aus.
Vorhandene Beschreibungen überschreiben¶
Um eine vom Benutzer eingegebene Beschreibung durch eine generierte Beschreibung zu ersetzen, gehen Sie wie folgt vor:
Melden Sie sich bei Snowsight als Benutzer mit den erforderlichen Berechtigungen an.
Navigieren Sie zu der Tabelle oder Ansicht, für die Sie Beschreibungen bearbeiten möchten.
Wählen Sie ein Warehouse aus, wenn es noch nicht in Gebrauch ist.
Bearbeiten Sie die Beschreibungen für Tabellen, Ansichten und Spalten:
Tabellen und Ansichten: Wählen Sie auf der Registerkarte Table Details das Bleistiftsymbol, um die vorhandene Beschreibung zu bearbeiten, und wählen Sie Generate with Cortex.
Spalten: Wählen Sie auf der Registerkarte Columns das Bleistiftsymbol für vorhandene Beschreibungen, und wählen Sie Generate with Cortex.
Wählen Sie Save aus.
Anforderungen an die Zugriffssteuerung¶
Benutzer benötigen alle der folgenden Elemente, um mit Snowflake Cortex Beschreibungen zu erstellen:
OWNERSHIP-Berechtigung für die Tabelle oder Ansicht.
Die Berechtigung USAGE für ein Warehouse.
Die SNOWFLAKE.CORTEX_USER Datenbankrolle zur Verwendung von Snowflake Cortex.
Der Kontoadministrator kann zum Beispiel Folgendes ausführen, damit Benutzer mit der Rolle table_owner_role
Beschreibungen für ihre Tabellen erstellen können:
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;
Beispieldateneingaben¶
Wenn Sie eine Beschreibung für eine Spalte erstellen, können Sie sich nur auf Metadaten verlassen oder Sie können Beispieldaten verwenden, um die Snowflake Cortex-gesteuerten Beschreibungen zu verbessern. Beispieldaten beziehen sich auf Daten innerhalb einer bestimmten Spalte, die ausgewertet werden, wenn Sie Snowflake Cortex zur Erstellung von Beschreibungen verwenden. Wenn Sie sich für die Verwendung von Beispieldaten entscheiden, verwendet Snowflake einen Teil der Beispieldaten, um die Beschreibung zu erstellen, was zu genaueren Beschreibungen führt. Beispieldaten werden von Snowflake nicht als Nutzungsdaten gespeichert.
Die Entscheidung über die Verwendung von Beispieldaten hängt von dem jeweiligen Benutzer ab. Wenn Sie zum ersten Mal eine Spaltenbeschreibung in einer Browsersitzung erstellen, werden Sie gefragt, ob Sie Beispieldaten verwenden möchten. Das Popup-Fenster ist standardmäßig auf „Ja“ eingestellt und bietet Ihnen die Möglichkeit, die Beispieldaten zu deaktivieren, bevor Sie fortfahren. Ihr Browser speichert Ihre Antwort auf diese Frage für die Dauer Ihrer Snowflake-Sitzung, und Sie werden erst bei Ihrer nächsten Sitzung wieder gefragt. Sie können auch Ihr Benutzerprofil verwenden, um festzulegen, ob Sie Beispieldaten verwenden möchten.
Bemerkung
Beispieldaten können regionale Grenzen überschreiten, wenn die Region Snowflake Cortex unterstützt. Weitere Informationen dazu finden Sie unter Zugriff auf das Feature.
Hinweise zu Kosten¶
Das Erstellen von Beschreibungen verursacht die folgenden Kosten:
Vom verwendeten Warehouse verbrauchte Credits
Credit-Gebühren für die Benutzung von Snowflake Cortex mit kleineren LLMs wie Mistral-7b und Llama 3.1-8b. Diese Gebühren erscheinen auf der Rechnung als AI-Services, die alle Nutzungen von Snowflake Cortex umfassen.
Rechtliche Hinweise¶
Die Datenklassifizierung der Eingaben und Ausgaben ist in der folgenden Tabelle aufgeführt.
Klassifizierung von Eingabedaten |
Klassifizierung von Ausgabedaten |
Benennung |
---|---|---|
Usage Data |
Usage Data |
Covered AI Features [1] |
Weitere Informationen dazu finden Sie unter KI und ML in Snowflake.