Kategorien:: DDL für Tabellen, Ansichten und Sequenzen

CREATE MATERIALIZED VIEW¶

Erstellt eine neue materialisierte Ansicht im aktuellen/angegebenen Schema auf Grundlage einer Abfrage einer vorhandenen Tabelle und füllt die Ansicht mit entsprechenden Daten aus.

Weitere Details dazu finden Sie unter Verwenden von materialisierten Ansichten.

Siehe auch:: ALTER MATERIALIZED VIEW, DROP MATERIALIZED VIEW, SHOW MATERIALIZED VIEWS, DESCRIBE MATERIALIZED VIEW

Unter diesem Thema:

Syntax
Erforderliche Parameter
Optionale Parameter
Nutzungshinweise
Beispiele

Syntax¶

CREATE [ OR REPLACE ] [ SECURE ] MATERIALIZED VIEW [ IF NOT EXISTS ] <name>
  [ COPY GRANTS ]
  ( <column_list> )
  [ <col1> [ WITH ] MASKING POLICY <policy_name> [ USING ( <col1> , <cond_col1> , ... ) ]
           [ WITH ] TAG ( <tag_name> = '<tag_value>' [ , <tag_name> = '<tag_value>' , ... ] ) ]
  [ , <col2> [ ... ] ]
  [ [ WITH ] ROW ACCESS POLICY <policy_name> ON ( <col_name> [ , <col_name> ... ] ) ]
  [ WITH ] TAG ( <tag_name> = '<tag_value>' [ , <tag_name> = '<tag_value>' , ... ] ) ]
  [ COMMENT = '<string_literal>' ]
  [ CLUSTER BY ( <expr1> [, <expr2> ... ] ) ]
  AS <select_statement>

Erforderliche Parameter¶

Name

Gibt den Bezeichner für die Ansicht an. Dieser muss für das Schema, in dem die Ansicht erstellt wird, eindeutig sein.

Darüber hinaus muss der Bezeichner mit einem Buchstaben beginnen und darf keine Leer- oder Sonderzeichen enthalten, es sei denn, die gesamte Bezeichnerzeichenfolge wird in doppelte Anführungszeichen gesetzt (z. B. "My object"). Bei Bezeichnern, die in doppelte Anführungszeichen eingeschlossen sind, ist auch die Groß-/Kleinschreibung zu beachten.

Weitere Details dazu finden Sie unter Anforderungen an Bezeichner.

Select-Anweisung

Gibt die Abfrage an, die zum Erstellen der Ansicht verwendet wird. Diese Abfrage dient als Text/Definition für die Ansicht. Diese Abfrage wird in der Ausgabe von SHOW VIEWS und SHOW MATERIALIZED VIEWS angezeigt.

Für die Select-Anweisung gelten Einschränkungen. Weitere Details dazu finden Sie unter:

Optionale Parameter¶

Spaltenliste:

Wenn Sie nicht möchten, dass die Spaltennamen in der Ansicht den Spaltennamen der zugrunde liegenden Tabelle entsprechen, können Sie eine Spaltenliste hinzufügen, in der Sie die Spaltennamen angeben. (Sie müssen die Datentypen der Spalten nicht angeben.)

Wenn Sie eine CLUSTER BY-Klausel für die materialisierte Ansicht angeben, müssen Sie die Spaltennamenliste einschließen.

MASKING POLICY = Name_der_Richtlinie

Gibt die Maskierungsrichtlinie an, die für eine Spalte festgelegt werden soll.

USING ( Spaltenname , Bedingte_Spalte_1 ... )

Gibt die Argumente an, die an den SQL-Ausdruck für die bedingte Maskierungsrichtlinie übergeben werden sollen.

Die erste Spalte in der Liste gibt die Spalte für die Richtlinienbedingungen zur Maskierung oder Tokenisierung der Daten an. Sie muss mit der Spalte übereinstimmen, für die die Maskierungsrichtlinie festgelegt ist.

Die zusätzlichen Spalten geben an, welche Spalten ausgewertet werden sollen, um zu ermitteln, ob die Daten in der jeweiligen Zeile des Abfrageergebnisses maskiert oder tokenisiert werden sollen, wenn auf der ersten Spalte eine Abfrage ausgeführt wird.

Wenn die USING-Klausel weggelassen wird, behandelt Snowflake die bedingte Maskierungsrichtlinie wie eine normale Maskierungsrichtlinie.

ROW ACCESS POLICY Name_der_Richtlinie ON ( Spaltenname [ , Spaltenname ... ] )

Gibt die Zeilenzugriffsrichtlinie an, die für die materialisierte Ansicht festgelegt werden soll.

TAG ( Tag-Name = 'Tag-Wert' [ , Tag-Name = 'Tag-Wert' , ... ] )

Gibt den Tag-Namen (d. h. den Schlüssel) und den Tag-Wert an.

Der Tag-Wert ist immer eine Zeichenfolge, die maximale 256 Zeichen lang sein kann. Die maximale Anzahl von eindeutigen Tag-Schlüsseln, die für ein Objekt festgelegt werden können, ist 20.

Bemerkung

Für eine Tabelle oder Ansicht und deren Spalten ist die Gesamtzahl der eindeutigen Tag-Schlüssel, die gesetzt werden können, 20.

Wenn beispielsweise für eine einzelne Spalte einer Tabelle 10 eindeutige Tag-Schlüssel gesetzt wurden, erlaubt Snowflake das Setzen von 10 zusätzlichen eindeutigen Tag-Schlüsseln entweder für diese Spalte, für andere Spalten in der Tabelle, für die Tabelle selbst oder für eine Kombination aus der Tabelle und deren Spalten. Sobald die Grenze von 20 eindeutigen Tag-Schlüsseln erreicht ist, können keine weiteren Tag-Schlüssel für die Tabelle oder deren Spalten gesetzt werden.

Zeichenfolgenliteral

Gibt einen Kommentar für die Ansicht an. Das Zeichenfolgenliteral sollte in einfache Anführungszeichen gesetzt werden. (Das Zeichenfolgenliteral sollte keine einfachen Anführungszeichen enthalten, es sei denn, es werden Escapezeichen verwendet.)

Standard: Kein Wert.

Ausdruck#

Gibt einen Ausdruck an, für den die materialisierte Ansicht geclustert werden soll. Normalerweise ist jeder Ausdruck der Name einer Spalte in der materialisierten Ansicht.

Weitere Informationen zum Clustering materialisierter Ansichten finden Sie unter Materialisierte Ansichten und Clustering. Weitere Informationen zum Clustering im Allgemeinen finden Sie unter Was ist Daten-Clustering?.

SECURE

Gibt an, dass die Ansicht sicher ist. Weitere Informationen zu sicheren Ansichten finden Sie unter Verwenden von sicheren Ansichten.

Standard: Kein Wert (Ansicht ist nicht sicher)

COPY GRANTS

Wenn Sie eine vorhandene Ansicht mithilfe der OR REPLACE-Klausel ersetzen, behält die Ersatzansicht die Zugriffsberechtigungen der ursprünglichen Ansicht bei. Dieser Parameter kopiert alle Berechtigungen, außer OWNERSHIP, aus der vorhandenen Ansicht in die neue Ansicht. Die neue Ansicht übernimmt keine zukünftigen Berechtigungen, die für den Objekttyp im Schema definiert werden. Die Rolle, die die Anweisung CREATE MATERIALIZED VIEW ausführt, besitzt standardmäßig die neue Ansicht.

Wenn der Parameter nicht in der CREATE VIEW-Anweisung enthalten ist, übernimmt die neue Ansicht keine expliziten Zugriffsberechtigungen für die ursprüngliche Ansicht, übernimmt aber alle zukünftigen Berechtigungen, die für den Objekttyp im Schema definiert werden.

Beachten Sie, dass die Operation zum Kopieren von Berechtigungen atomar mit der CREATE VIEW-Anweisung erfolgt (d. h. innerhalb derselben Transaktion).

Standard: Kein Wert (Berechtigungen werden nicht kopiert)

Nutzungshinweise¶

Das Erstellen einer materialisierten Ansicht erfordert die CREATE MATERIALIZED VIEW-Berechtigung für das Schema und die SELECT-Berechtigung für die Basistabelle. Weitere Informationen zu Berechtigungen und materialisierten Ansichten finden Sie unter Berechtigungen für das Schema einer materialisierten Ansicht.
Wenn Sie einen Namen für die materialisierte Ansicht wählen, beachten Sie, dass ein Schema keine Tabelle und keinen Ansicht gleichen Namens enthalten darf. Eine CREATE [ MATERIALIZED ] VIEW-Anweisung erzeugt einen Fehler, wenn im Schema bereits eine Tabelle mit dem gleichen Namen existiert.
Beachten Sie bei der Angabe der Select-Anweisung das Folgende:
- Sie Dürfen weder eine HAVING-Klausel noch eine ORDER BY-Klausel angeben.
- Wenn Sie eine CLUSTER BY-Klausel für die materialisierte Ansicht angeben, müssen Sie die Spaltenliste-Klausel einfügen.
- Wenn Sie in der Select-Anweisung mehr als einmal auf die Basistabelle verweisen, verwenden Sie für alle Verweise auf die Basistabelle denselben Qualifizierer.
  
  Verwenden Sie z. B. keine Mischung aus base_table, schema.base_table und database.schema.base_table in derselben Select-Anweisung. Wählen Sie stattdessen eine dieser Formen (z. B. database.schema.base_table) aus, und verwenden Sie diese konsistent in der gesamten SELECT-Anweisung.
- In der SELECT-Anweisung dürfen keine Streamobjekte abgefragt werden. Streams sind nicht als Quellobjekte für Ansichten oder materialisierte Ansichten vorgesehen.
Für materialisierte Ansichten gelten andere Einschränkungen. Weitere Details dazu finden Sie unter Einschränkungen beim Erstellen materialisierter Ansichten und Einschränkungen bei der Verwendung von materialisierten Ansichten.
Ansichtsdefinitionen werden nicht aktualisiert, wenn das Schema der zugrunde liegenden Quelltabelle geändert wird, sodass die Ansichtsdefinition ungültig wird. Beispiel:
- Es wird eine Ansicht erstellt, die auf eine bestimmte Spalte einer Quelltabelle verweist, und die Spalte wird anschließend aus der Tabelle gelöscht.
- Eine Ansicht wird mit SELECT * für eine Tabelle erstellt, und jede Spalte wird anschließend aus der Tabelle gelöscht.
In beiden Szenarien gibt die Abfrage der Ansicht einen Fehler zurück.
Wenn die Quelltabelle einer materialisierten Ansicht gelöscht wird, gibt die Abfrage der Ansicht folgenden Fehler zurück: Materialized View <Ansichtsname> is invalid.
Metadaten:

Achtung

Kunden müssen sicherstellen, dass bei der Nutzung des Snowflake-Dienstes keine personenbezogenen Daten (außer für ein Objekt „Benutzer“), sensible Daten, exportkontrollierte Daten oder andere regulierte Daten als Metadaten eingegeben werden. Weitere Informationen dazu finden Sie unter Metadatenfelder in Snowflake.
Die Verwendung von OR REPLACE ist gleichbedeutend mit der Ausführung von DROP MATERIALIZED VIEW auf der vorhandenen materialisierten Ansicht und der anschließenden Erstellung einer neuen Ansicht mit demselben Namen. Die Aktionen für Löschen und Erstellen erfolgen in einer einzigen atomaren Operation. Das bedeutet, dass alle Abfragen, die gleichzeitig mit der Operation CREATE OR REPLACE MATERIALIZED VIEW ausgeführt werden, entweder die alte oder die neue Version der materialisierten Ansicht verwenden.
Wenn Sie eine materialisierte Ansicht mit Maskierungsrichtlinie auf einer oder mehreren Spalten oder die materialisierte Ansicht selbst mit Zeilenzugriffsrichtlinie ändern, dann können Sie mit der Funktion POLICY_CONTEXT eine Abfrage auf den mit Maskierungsrichtlinie geschützten Spalten bzw. auf der mit einer Zeilenzugriffsrichtlinie geschützten materialisierten Ansicht simulieren.

Beispiele¶

Erstellen Sie im aktuellen Schema eine materialisierte Ansicht inklusive Kommentar, die alle Zeilen einer Tabelle auswählt:

CREATE MATERIALIZED VIEW mymv
    COMMENT='Test view'
    AS
    SELECT col1, col2 FROM mytable;

Weitere Beispiele finden Sie in den Beispielen in Verwenden von materialisierten Ansichten.