Semantic View Editor¶
Der Semantic View Editor in Snowsight bietet eine visuelle Schnittstelle zum Erstellen und Bearbeiten von semantischen Ansichten. Ganz gleich, ob Sie eine vom Autopilot erstellte Ansicht optimieren, eine Ansicht von Grund auf neu erstellen oder eine hochgeladenen YAML-Spezifikation bearbeiten möchten: Der Editor hilft Ihnen, Geschäftskonzepte, Metriken und Beziehungen zu Ihren Daten zu definieren.
Der Semantic View Editor bietet folgende Möglichkeiten:
Definieren von logischen Tabellen, die Ihren physischen Datenbanktabellen zugeordnet sind
Erstellen von Dimensionen (kategoriale Attribute), Fakten (Daten auf Zeilenebene) und Metriken (aggregierte Kennzahlen)
Herstellen von Beziehungen zwischen Tabellen
Hinzufügen verifizierter Abfragen als Beispiele für Cortex Analyst
Bereitstellen von benutzerdefinierten Anweisungen für die Erstellung von Abfragen
Konfigurieren von Synonymen und Beschreibungen, um die Auffindbarkeit zu verbessern
Zugriff auf den Editor¶
Sie können auf den Semantic View Editor über den Datenkatalog oder über Cortex Analyst zugreifen.
Über den Datenkatalog¶
So greifen Sie über den Datenkatalog auf eine vorhandene semantische Ansicht zu:
Melden Sie sich bei Snowsight an.
Wählen Sie im Navigationsmenü die Option Catalog » Database Explorer aus.
Navigieren Sie zu Ihrer Datenbank und Ihrem Schema.
Wählen Sie Semantic Views in der Objektliste aus.
Wählen Sie die semantische Ansicht aus, die Sie bearbeiten möchten.
Wählen Sie die Registerkarte Semantic information aus, um den Editor zu öffnen.
Über Cortex Analyst¶
So greifen Sie auf semantische Ansichten über Cortex Analyst zu:
Melden Sie sich bei Snowsight an.
Wählen Sie im Navigationsmenü die Option AI & ML » Cortex Analyst aus.
Wählen Sie die Registerkarte Semantic Views aus.
Entweder:
Wählen Sie eine vorhandene Ansicht aus, um sie zu bearbeiten.
Wählen Sie Create new aus, um eine neue semantische Ansicht zu erstellen.
Bearbeiten der Metadaten einer semantischen Ansicht¶
Der Name und die Beschreibung einer semantischen Ansicht helfen Benutzenden, den Zweck der Ansicht zu erkennen und zu verstehen.
So bearbeiten Sie den Namen oder die Beschreibung einer semantischen Ansicht:
Wählen Sie im Editor die Option Edit neben dem Namen der semantischen Ansicht oben auf der Seite aus.
Aktualisieren Sie das Feld Name oder Description.
Wählen Sie Save aus.
Tipp
Schreiben Sie klare, detaillierte Beschreibungen, die Folgendes erklären:
Welche Geschäftsfragen diese Ansicht beantworten kann
Welche Datenquellen sie enthält
Wer diese Ansicht verwenden sollte
Beispiel: „Umsatzanalyse über Produkte und Kunden hinweg, einschließlich Trends im Jahresverlauf. Verwenden Sie diese Ansicht, um die Vertriebsleistung nach Region, Produktkategorie und Kundensegment zu analysieren.“
Verwalten logischer Tabellen¶
Logische Tabellen repräsentieren Geschäftseinheiten (wie Kunden, Aufträge oder Produkte) und lassen sich physischen Datenbanktabellen oder Ansichten zuordnen. Jede semantische Ansicht enthält eine oder mehrere logische Tabellen.
Hinzufügen einer logischen Tabelle¶
So fügen Sie eine logische Tabelle zu Ihrer semantischen Ansicht hinzu:
Wählen Sie im Editor die Option + Logical Table aus.
Suchen Sie die physische Tabelle oder Ansicht Ihrer Datenbank, und wählen Sie diese aus.
Wählen Sie Next aus.
Wählen Sie aus, welche Spalten in die Tabelle aufgenommen werden sollen.
Wählen Sie Generate logical table aus.
Der Editor generiert automatisch Dimensionen und Fakten auf der Grundlage der ausgewählten Spalten.
Bearbeiten einer logische Tabelle¶
So ändern Sie eine bestehende logische Tabelle:
Wählen Sie Edit neben dem Tabellennamen aus (oder wählen Sie More options » Edit Logical Table).
Ändern Sie die Eigenschaften der Tabelle:
Name: Der geschäftsorientierte Name für diese Tabelle
Description: Erläuterung, was diese Tabelle darstellt
Synonyms: Alternative Namen (durch Komma getrennt)
Primary Key: Spalten, die Zeilen eindeutig identifizieren
Wählen Sie Save aus.
Tipp
Verwenden Sie die Schaltfläche Generate fields, damit die AI automatisch Beschreibungen und Synonyme basierend auf Ihren Daten und Spaltennamen ausfüllt. Dies kann die Ersteinrichtung erheblich beschleunigen.
Verwalten von Fakten, Dimensionen und Metriken¶
Innerhalb jeder logischen Tabelle definieren Sie die Geschäftskonzepte, die Benutzende abfragen können: Dimensionen, Fakten und Metriken.
Erläuterungen zu den Inhaltstypen¶
Dimensionen: Kategoriale Attribute, die Kontext liefern (z. B. , Kundenname, Produktkategorie oder Bestelldatum)
Fakten: Quantitative Daten auf Zeilenebene (z. B. Verkaufsbetrag, Menge oder Stückpreis)
Metriken: Aggregierte Kennzahlen, die aus Funktionen wie SUM, AVG oder COUNT berechnet werden (z. B. Gesamtumsatz, durchschnittlicher Bestellwert)
Hinzufügen von Dimensionen, Fakten oder Metriken¶
So fügen Sie ein neues Element zu einer logischen Tabelle hinzu:
Navigieren Sie im Editor zu der logischen Tabelle.
Wählen Sie + neben Dimensions, Facts oder Metrics aus.
Geben Sie die erforderlichen Details ein:
Name: Beschreibender Name für dieses Element
Expression: SQL-Ausdruck, um den Wert zu berechnen
Data Type: Der Datentyp des Ergebnisses
Wählen Sie Add aus.
Bearbeiten oder Entfernen von Elementen¶
So ändern oder löschen Sie eine bestehende Dimension, einen Fakt oder eine Metrik:
Wählen Sie das Element aus, um seine Details zu öffnen und Eigenschaften zu bearbeiten.
Oder wählen Sie More options » Remove aus, um das Element zu löschen.
Wählen Sie Save aus, um Änderungen zu übernehmen.
Erweiterte Features¶
Abgeleitete Metriken: Sie können Metriken auf Ansichtsebene erstellen, die Metriken aus mehreren Tabellen kombinieren. Weitere Informationen dazu finden Sie unter Abgeleitete Metriken definieren.
Modifikatoren für den privaten Zugriff: Markieren Sie Fakten oder Metriken als privat, um sie vor Abfragen zu verbergen , aber dennoch in anderen Berechnungen zu verwenden. Weitere Informationen dazu finden Sie unter Tatsache oder Metrik als privat markieren.
Bevorzugte Verknüpfungspfade für Metriken: Wenn es mehrere Beziehungspfade zwischen zwei logischen Tabellen gibt, können Sie die zu verwendende Beziehung aus dem Menü Preferred join path auswählen.
Verwalten von Beziehungen¶
Beziehungen definieren, wie logische Tabellen miteinander verknüpft werden, und ermöglichen Abfragen, die sich über mehrere Tabellen erstrecken. Jede Beziehung definiert, welche Spalten einer Tabelle auf Spalten einer anderen Tabelle verweisen.
Hinzufügen einer Beziehung¶
So erstellen Sie eine Beziehung zwischen zwei logischen Tabellen:
Wählen Sie im Editor die Option + neben Relationships aus.
Geben Sie einen beschreibenden Name für die Beziehung ein (zum Beispiel „orders_to_customers“).
Wählen Sie die Left Table aus (die Tabelle mit dem Fremdschlüssel).
Wählen Sie die Right Table aus (die Tabelle, auf die verwiesen wird).
Geben Sie die Join Columns für jede Tabelle an.
Left Column: Die Fremdschlüsselspalten in der linken Tabelle
Right Column: Der Primärschlüssel- oder eindeutige Spalten in der rechten Tabelle
Wählen Sie Add aus.
Die Beziehung wird jetzt in der Liste der Beziehungen angezeigt und ermöglicht Cortex Analyst, Abfragen zu generieren, die diese Tabellen verknüpfen.
Bemerkung
Für semantische Ansichten müssen Sie in der Regel keine Verknüpfungstypen (linke äußere, innere) oder Beziehungstypen (eins zu eins, viele zu eins) angeben. Diese werden automatisch aus den Daten und den Definitionen der Primärschlüssel zum Zeitpunkt der Abfrage abgeleitet.
Bearbeiten oder Entfernen von Beziehungen¶
So ändern oder löschen Sie eine Beziehung:
Wählen Sie die Beziehung aus, um ihre Details anzuzeigen.
Bearbeiten Sie die Eigenschaften nach Bedarf, oder wählen Sie Remove aus, um sie zu löschen.
Wählen Sie Save aus, um Änderungen zu übernehmen.
Erweiterte Features für Cortex Analyst¶
Zur Verbesserung der Genauigkeit und Zuverlässigkeit von Cortex Analyst können Sie Kontext und Anleitungen durch geprüfte Abfragen, Synonyme und benutzerdefinierte Anweisungen hinzufügen.
Geprüfte Abfragen¶
Geprüfte Abfragen liefern Beispielfragen mit ihren korrekten SQL-Antworten. Sie erfüllen zwei Zwecke:
Sie unterstützen Cortex Analyst dabei, ähnliche Fragen richtig zu beantworten.
Sie stellen vorgeschlagene Fragen für Benutzende bereit, um den Einstieg zu erleichtern.
Hinzufügen einer geprüften Abfrage:
Wählen Sie + neben Verified Queries aus.
Geben Sie eine Question in natürlicher Sprache ein (z. B. „Was sind die Top-10-Produkte nach Umsatz?“).
Geben Sie die entsprechende SQL Query ein, die die Frage korrekt beantwortet.
(Optional) Prüfen Sie Use as onboarding question, um dies Benutzenden als Vorschlag anzuzeigen.
Wählen Sie Add aus.
Tipp
Fügen Sie geprüfte Abfragen hinzu für:
Gängige Geschäftsfragen, die Benutzende wahrscheinlich stellen werden
Komplexe Abfragen, die eine bestimmte Logik erfordern
Grenzfälle oder ungewöhnliche Berechnungen
Fragen, die die Möglichkeiten der Ansicht demonstrieren
Synonyme¶
Bemerkung
Fügen Sie Synonyme manuell hinzu, anstatt sie automatisch mit AI zu generieren. Konzentrieren Sie sich auf domänenspezifische Alternativen wie interne Terminologie, Abkürzungen oder ältere Namen. Automatisch generierte Synonyme verringern oft die Qualität der semantischen Ansicht.
Synonyme helfen Benutzenden, Ihre Daten mithilfe alternativer Terminologie zu erkunden und abzufragen. Beispielsweise können Benutzende „Kunden“ als „Klienten“ oder „Konten“ bezeichnen.
Hinzufügen von Synonymen zu einer Tabelle oder einem Feld:
Navigieren Sie zu der Tabelle, Dimension, Metrik oder dem Fakt, für die Sie Synonyme hinzufügen möchten.
Wählen Sie Edit aus, um die Eigenschaften des Elements zu öffnen.
Geben Sie im Feld Synonyms durch Kommas getrennte Alternativbegriffe ein.
Wählen Sie Save aus.
Beispiele für Synonyme:
Bei einer Dimension „Kundenname“: „Klientenname, Kontoname, Käufername“
Bei einer Metrik „Umsatz“: „Verkäufe, Einnahmen, Erlöse“
Bei einer Tabelle „Bestellungen“: „Kundenaufträge, Käufe“
Kundenspezifische Anweisungen¶
Benutzerdefinierte Anweisungen bieten Cortex Analyst spezifische Hinweise für die SQL-Generierung und Kategorisierung von Fragen. Verwenden Sie benutzerdefinierte Anweisungen zum:
Definieren von Geschäftsregeln und Einschränkungen
Angeben von Standardverhaltensweisen
Verarbeiten mehrdeutiger Fragen
Ablehnen bestimmter Arten von Fragen
Fügen Sie eine benutzerdefinierte Anweisung hinzu, indem Sie folgende Schritte ausführen:
Wählen Sie im Editor den Abschnitt Custom Instructions aus.
Geben Sie Anweisungen in natürlicher Sprache ein. Beispiele:
„immer nach aktiven Kunden (status = ‚ACTIVE‘) filtern, sofern nicht anders angegeben“
„Alle Geldwerte auf 2 Dezimalstellen runden“
„Bei der Fragen nach dem Umsatz die Metrik net_revenue verwenden, es sei denn, es wird ausdrücklich der Bruttoumsatz angefragt“
„Wenn eine Frage nach Benutzenden fragt, ohne eine Region anzugeben, den Benutzenden bitten anzugeben, welche Region“
Wählen Sie Save aus.
Weitere Informationen zu benutzerdefinierten Anweisungen für semantische Ansichten finden Sie unter Bereitstellung kundenspezifischer Anweisungen für Cortex Analyst.
Hochladen einer YAML-Datei¶
Wenn Sie eine bestehende YAML -Spezifikation für eine semantische Ansicht oder eine ältere YAML-Datei für ein semantisches Modell haben, können Sie diese hochladen, um eine neue semantische Ansicht zu erstellen oder eine bestehende Ansicht zu aktualisieren.
So laden Sie eine YAML-Datei hoch:
Wählen Sie im Navigationsmenü die Option AI & ML » Cortex Analyst aus.
Wählen Sie Create new » Upload YAML file aus.
Suchen Sie nach der YAML-Datei und wählen Sie sie aus.
Überprüfen Sie die generierte Struktur der semantischen Ansicht im Editor.
Wählen Sie Convert and save aus, um die semantische Ansicht als Objekt auf Schemaebene zu erstellen.
Der Editor konvertiert die YAML-Spezifikation in eine native semantische Snowflake-Ansicht, die Sie dann über die visuelle Schnittstelle bearbeiten können.
Weitere Informationen zum Format der YAML-Spezifikation finden Sie unter YAML-Spezifikation für semantische Ansichten.
Informationen über die programmgesteuerte Konvertierung einer Spezifikation in eine semantische Ansicht finden Sie unter Semantischen Ansicht aus einer YAML-Spezifikation erstellen.