Snowsight zum Erstellen und Verwalten von semantischen Ansichten verwenden¶

In Snowsight können Sie semantische Ansichten erstellen und verwalten:

Erstellen einer semantischen Ansicht
- Using the AI-assisted generator to create a semantic view
- YAML-Spezifikation zum Erstellen einer semantischen Ansicht hochladen
Bearbeiten einer semantischen Ansicht
Berechtigung zur Verwendung einer semantischen Ansicht einer anderen Rolle gewähren

Erstellen einer semantischen Ansicht¶

In Snowsight können Sie eine semantische Ansicht mithilfe eines Assistenten oder durch Hochladen einer Spezifikation des semantischen Modells erstellen.

YAML-Spezifikation zum Erstellen einer semantischen Ansicht hochladen

Bemerkung

To create a semantic view, you must use a role with the following privileges:

CREATE SEMANTIC VIEW on the schema where you are creating the semantic view.
USAGE on the database and schema where you are creating the semantic view.
SELECT on the tables and views used in the semantic view.

Using the AI-assisted generator to create a semantic view¶

Verwenden Sie den AI-unterstützten Generator, um eine semantische Ansicht zu erstellen, die semantische Informationen aus mehreren Quellen kombiniert. Anstatt eine semantische Ansicht manuell mit Ihrer eigenen YAML-Spezifikation zu erstellen, können Sie den Modellgenerator in Snowsight verwenden, um Zeit zu sparen. Für das Erstellen einer semantischen Ansicht sind folgende Informationen erforderlich:

Eine Beschreibung mit grundlegenden Informationen über die Ansicht
Kontext, z. B SQL-Abfragen
Die Datenquelle (mindestens eine Tabelle oder Ansicht), die Sie verwenden
Die Spalten, die Sie verwenden

Der AI-unterstützte Generator verarbeitet Eingaben auf folgende Weise:

SQL-Beispielabfragen
- Überprüfen Sie die Liste der Abfragen, und löschen Sie ungültige Abfragen.
- Extrahieren Sie alle Tabellen und Spalten aus den Abfragen, und legen Sie sie zur Überprüfung vor, bevor Sie sie der semantischen Ansicht hinzufügen.
- Extrahieren Sie Beziehungen aus den Abfragen.
- Fügen Sie gültige Abfragen der semantischen Ansicht als verifizierte Abfragen hinzu.
Tabellenmetadaten
- Extrahieren Sie alle Tabellen- und Spaltenbeschreibungen.
- Fügen Sie der semantischen Ansicht Primärschlüssel und eindeutige Schlüssel hinzu, indem Sie Metadaten analysieren oder diskrete Werte zählen, um die Kardinalität und Beziehungstypen zu bestimmen.
Abfrageverlauf
- Ermitteln historischer SQL-Abfragen als Vorschläge für die semantische Ansicht. Der AI-unterstützte Generator identifiziert die gängigsten Typen von Abfragen, die in die Grenzen der ausgewählten Tabellen und Spalten passen.
- Suchen Sie gültige Beziehungen und Spaltentypen für die semantische Ansicht.
- Cortex Analyst verwendet den Abfrageverlauf, auf den die Rolle für die Erstellung des semantischen Modells Zugriff hat, um sowohl Beziehungen als auch verifizierte Abfragevorschläge zu generieren.

Melden Sie sich bei Snowsight an.
Wählen Sie im Navigationsmenü die Option AI & ML » Cortex Analyst aus.
At the top of the navigation menu, select Create new » Create new Semantic View.
Wählen Sie einen Speicherort für die neue semantische Ansicht aus.
Enter a name for the semantic view.
Geben Sie unter Description Informationen über die semantische Ansicht an.
Wählen Sie Next aus.
Um Kontext bereitzustellen, fügen Sie die folgenden Informationen hinzu:
- Stellen Sie für SQL Queries Beispielfragen und die zugehörigen SQL-Abfragen bereit, die Sie als Teil der Ansicht verwenden möchten.
For Select tables, provide the data source that you’re using to create the semantic view.

Sie müssen mindestens eine Tabelle oder Ansicht bereitstellen. Es gibt keine Begrenzung für die Tabellen oder Ansichten, die Sie angeben können, aber Snowflake empfiehlt, nicht mehr als 10 zu verwenden.
Wählen Sie Next aus.
Wählen Sie unter Select columns die Spalten aus, die Sie zur Erstellung der semantischen Ansicht verwenden.

Sie können alle Spalten oder bestimmte Spalten auswählen. Aus Leistungsgründen empfiehlt Snowflake, nicht mehr als 50 Spalten zu verwenden.
Wählen Sie aus, ob Sie Beispielwerte aus jeder Spalte zur semantischen Ansicht hinzufügen möchten. Beispielwerte helfen, die Genauigkeit der Ergebnisse von Cortex Analyst zu verbessern.
Wählen Sie aus, ob Sie der semantischen Ansicht AI-generierte Beschreibungen für Tabellen und Spalten hinzufügen möchten. Die AI-generierten Beschreibungen basieren auf den Spaltennamen und Beispielwerten.
Wählen Sie Create and save aus. Sie können den Fortschritt der Ansichtsgenerierung, einschließlich Details zu den Schritten, die der Generator ausführt, auf der Seite der semantischen Ansicht anzeigen. Der Vorgang kann einige Minuten dauern.
Optional: Um weitere Änderungen vorzunehmen, bearbeiten Sie entweder die Ansicht in der Snowsight oder direkt die YAML-Datei.

Cortex Analyst generiert automatisch Vorschläge zur Verbesserung der semantischen Ansicht nach der Erstellung. Nachdem die Vorschläge angezeigt wurden, was einige Minuten dauern kann, können Sie diese überprüfen und bei Bedarf auf die Ansicht anwenden.

YAML-Spezifikation zum Erstellen einer semantischen Ansicht hochladen¶

Wenn Sie planen, die semantische Ansicht von Cortex Analyst zu erstellen, erstellen Sie einen Stagingbereich für die YAML-Datei.
Laden Sie die YAML-Datei auf eine der folgenden Arten hoch:
- Datenbankobjekt-Explorer:
  1. Melden Sie sich bei Snowsight an.
  2. Wählen Sie im Navigationsmenü die Option Catalog » Database Explorer aus.
  3. Wählen Sie die Datenbank und das Schema für das Erstellen des Stagingbereichs aus.
  4. Wählen Sie Create » Semantic View » Upload YAML file aus.
  5. Wählen Sie die YAML-Datei aus, die hochgeladen werden soll.
  6. Wählen Sie unter Select database, schema and stage die Datenbank, das Schema und den Stagingbereich zum Hochladen der YAML-Datei aus.
  7. Wenn Sie die YAML-Datei in einen bestimmten Pfad im Stagingbereich hochladen möchten, geben Sie diesen Pfad an.
  8. Wählen Sie Upload aus.
- Cortex Analyst:
  1. Melden Sie sich bei Snowsight an.
  2. Wählen Sie im Navigationsmenü die Option AI & ML » Cortex Analyst aus.
  3. Wählen Sie Create new » Upload YAML file aus.
  4. Wählen Sie die YAML-Datei aus, die hochgeladen werden soll.
  5. Wählen Sie Convert and save aus.

Bearbeiten einer semantischen Ansicht¶

Bemerkung

Das Bearbeiten einer semantischen Ansicht in Snowsight führt dazu, dass die vorhandene Ansicht ersetzt wird. Um eine bestehende semantische Ansicht zu ersetzen, müssen Sie eine Rolle verwenden, der die folgenden Berechtigungen zugewiesen wurden:

CREATE SEMANTIC VIEW on the schema where you are creating the semantic view.
USAGE on the database and schema where you are creating the semantic view.
SELECT on the tables and views used in the semantic view.

So bearbeiten Sie eine semantische Ansicht:

Greifen Sie auf eine der folgenden Arten auf die semantische Ansicht zu:
- Datenbankobjekt-Explorer:
  1. Melden Sie sich bei Snowsight an.
  2. Wählen Sie im Navigationsmenü die Option Catalog » Database Explorer aus.
  3. Wählen Sie die Datenbank und das Schema aus, die die semantische Ansicht enthalten.
  4. Wählen Sie Semantic views aus.
  5. Wählen Sie die semantische Ansicht aus.
  6. Wählen Sie die Registerkarte Semantic information aus.
- Cortex Analyst:
  1. Melden Sie sich bei Snowsight an.
  2. Wählen Sie im Navigationsmenü die Option AI & ML » Cortex Analyst aus.
  3. Wählen Sie die Registerkarte Semantic views aus.
  4. Wählen Sie unter Select database to see semantic views die Datenbank und das Schema aus, die die semantische Ansicht enthalten, die Sie bearbeiten möchten.
  5. Wählen Sie die semantische Ansicht aus, die Sie bearbeiten möchten.
Nehmen Sie Änderungen an der semantischen Ansicht vor. Sie können die folgenden Arten von Änderungen vornehmen:
- So ändern Sie den Namen oder die Beschreibung der semantischen Ansicht:
  1. Wählen Sie neben dem Namen der semantischen Ansicht Edit aus.
  2. Nehmen Sie Änderungen am Namen oder der Beschreibung vor.
  3. Wählen Sie Apply aus.
- So fügen Sie der semantischen Ansicht eine neue logische Tabelle hinzu:
  1. Wählen Sie im Datenbankobjekt-Explorer + Logical Table oder + in Cortex Analyst aus.
  2. Select a table im Assistenten:
    1. Wählen Sie die Tabelle oder Ansicht aus, die die Daten enthält, die Sie in Ihrer semantischen Ansicht verwenden möchten.
    2. Wählen Sie Next aus.
  3. Im Schritt Select columns des Assistenten:
    1. Wählen Sie die Spalten aus, die in die Ansicht aufgenommen werden sollen.
      
      Um alle Spalten in einer Tabelle oder Ansicht auszuwählen, markieren Sie die Tabelle oder Ansicht.
    2. Wählen Sie Generate logical table aus.
- Änderungen an Name, Beschreibung, Synonyme oder Primärschlüssel einer logischen Tabelle in der semantischen Ansicht vornehmen:
  1. Wählen Sie neben dem Namen der logischen Tabelle im Datenbankobjekt-Explorer » Edit Logical Table oder Edit neben dem Namen der logischen Tabelle in Cortex Analyst aus.
  2. Nehmen Sie Ihre Änderungen an dem Namen, der Beschreibung, den Synonyme und den Primärschlüssel vor.
    
    Wenn Sie keine Beschreibung oder Synonyme angegeben haben, können Sie Generate fields auswählen, um diese Felder automatisch auszufüllen.
  3. Wählen Sie Save aus.
- So fügen Sie einen Fakt, eine Dimension oder eine Metrik hinzu:
  1. Öffnen des Formulars zum Hinzufügen des neuen Elements:
    - Wählen Sie im Datenbankobjekt-Explorer und dann Fact Dimension oder Metric.
    - Wählen Sie im Cortex Analyst + neben Facts, Dimensions`oder :ui:`Metrics aus.
  2. Geben Sie Informationen zu dem neuen Fakt, der Dimension oder der neuen Metrik ein, und wählen Sie Add aus.
- So ändern oder entfernen Sie einen Fakt, eine Dimension oder eine Metrik:
  1. Wählen Sie Facts, Dimensions oder Metrics aus, um die Liste der Fakten, Dimensionen oder Metriken anzuzeigen.
  2. Gehen Sie für Fakten, Dimensionen oder Metriken, die Sie ändern möchten, wie folgt vor:
    - Wählen Sie Edit aus, um das Element zu ändern.
    - Wählen Sie » Remove fact, Remove dimension oder Remove metric aus, um das Element zu entfernen.
- So fügen Sie eine Beziehung hinzu:
  1. Öffnen des Formulars zum Hinzufügen des neuen Elements:
    - Wählen Sie im Datenbankobjekt-Explorer + Relationship aus.
    - Wählen Sie in Cortex Analyst + neben Relationships aus.
  2. Geben Sie einen Namen für die Beziehung ein, wählen Sie die Tabellen in der Beziehung aus, und wählen Sie die Spalten aus, die zum Verknüpfen der Tabellen verwendet werden sollen.
  3. Wählen Sie Add aus.
Wenn Sie Cortex Analyst verwenden möchten, beachten Sie bei dieser Ansicht Folgendes:
- Fügen Sie im Abschnitt Beispielabfragen Verified Queries hinzu.Beachten Sie, dass dieser Abschnitt nur in Cortex Analyst verfügbar ist.
  - Dies sind Beispielabfragen, die Cortex Analyst helfen zu verstehen, wie man die semantische Ansicht verwendet.
  - Fügen Sie Abfragen hinzu, die häufige Anwendungsfälle für Ihre Daten darstellen.
- Fügen Sie Synonyme für Ihre Tabellen, Fakten, Dimensionen oder Metriken hinzu.
  - Dies sind alternative Begriffe, die Benutzer in Abfragen verwenden können.
  - Synonyme helfen Cortex Analyst, die Fragen der Benutzer richtig zu interpretieren.
- Benutzerdefinierte Anweisungen hinzufügen.
  - Diese liefern zusätzlichen Kontext darüber, wie die Daten zu interpretieren sind.
  - Fügen Sie Geschäftsregeln oder Einschränkungen hinzu, die berücksichtigt werden sollten.
Wählen Sie Save aus.

Berechtigung zur Verwendung einer semantischen Ansicht einer anderen Rolle gewähren¶

So gewähren Sie einer anderen Rolle die Berechtigung zum Anzeigen und Abfragen einer semantischen Ansicht:

Greifen Sie auf eine der folgenden Arten auf die semantische Ansicht zu:
- Datenbankobjekt-Explorer:
  1. Melden Sie sich bei Snowsight an.
  2. Wählen Sie im Navigationsmenü die Option Catalog » Database Explorer aus.
  3. Wählen Sie die Datenbank und das Schema aus, die die semantische Ansicht enthalten.
  4. Wählen Sie Semantic views aus.
  5. Wählen Sie die semantische Ansicht aus.
  6. Wählen Sie » Share aus.
- Cortex Analyst:
  1. Melden Sie sich bei Snowsight an.
  2. Wählen Sie im Navigationsmenü die Option AI & ML » Cortex Analyst aus.
  3. Wählen Sie die Registerkarte Semantic views aus.
  4. Wählen Sie die semantische Ansicht aus.
  5. Wählen Sie Share aus.
Wählen Sie die Rolle aus, der Sie die Berechtigung zur Anzeige und Abfrage der semantischen Ansicht gewähren möchten.
Wählen Sie Done aus.

Dadurch werden in der semantischen Ansicht die Berechtigungen SELECT und REFERENCES der ausgewählten Rolle gewährt.

Semantische Ansicht abfragen¶

Wenn Sie eine semantische Ansicht im Datenbankobjekt-Explorer anzeigen, können Sie ein Arbeitsblatt öffnen, um eine Abfrage für diese Ansicht zu erstellen, indem Sie » Query with SQL auswählen.

Weitere Informationen zum Erstellen der Abfrage finden Sie unter Semantische Ansichten abfragen.

Best Practices für das Erstellen einer semantischen Ansicht¶

Liefern Sie klare Beschreibungen:
- Verwenden Sie in allen Namen und Beschreibungen Geschäftsterminologie.
- Machen Sie die Beschreibungen so ausführlich, dass sie auch für nicht-technische Benutzer verständlich sind.
Beziehen Sie repräsentative Fragen der Benutzer ein:
- Fügen Sie Fragen ein, die dem Modellgenerator helfen können, Ihre Absicht besser zu verstehen.
- Fügen Sie Variationen hinzu, wie die Fragen gestellt werden könnten.
Prüfen Sie die generierten Vorschläge sorgfältig:
- Stellen Sie sicher, dass die Fragen für den Anwendungsfall relevant sind.
- Stellen Sie sicher, dass die vorgeschlagenen Beziehungen Ihrem Geschäftsverständnis entsprechen.
Testen Sie mit echten Fragen:
- Nachdem Sie Ihre semantische Ansicht erstellt haben, testen Sie sie mit tatsächlichen Geschäftsfragen.
- Verfeinern Sie Ihre semantische Ansicht, je nachdem, wie gut das Modell diese Fragen unterstützt.
Iterieren Sie bei der Entwicklung der semantischen Ansicht:
- Beginnen Sie mit einem einfachen Sternschema.
- Beginnen Sie mit den wichtigsten Tabellen und Metriken und erweitern Sie dann. Wir schlagen drei Tabellen vor, um die Dinge einfach zu halten.
- Holen Sie das Feedback der Geschäftsanwender ein und verfeinern Sie Ihre semantische Ansicht.

Problembehandlung¶

Wenn Ihre semantische Ansicht nicht in der Liste der Ansichten aufgeführt ist, aktualisieren Sie die Liste der Modelle (nicht die Seite selbst).
Wenn bei den Beziehungen in der semantischen Ansicht Fehler auftreten, stellen Sie sicher, dass diese Beziehungen mit der tatsächlichen Datenstruktur übereinstimmen.
Wenn Abfragen langsam sind, reduzieren Sie die Anzahl der Tabellen oder Spalten.
Wenn Cortex Analyst bei der Verwendung Ihrer semantischen Ansicht unerwartete Ergebnisse liefert, überprüfen Sie die Fakten, Dimensionen und Metriken in der semantischen Ansicht.