Kategorien:

Datenpipeline DDL

ALTER STREAM

Ändert die Eigenschaften, Spalten oder Beschränkungen für einen bestehenden Stream.

Siehe auch:

CREATE STREAM, DROP STREAM, SHOW STREAMS, DESCRIBE STREAM

Unter diesem Thema:

Syntax

ALTER STREAM [ IF EXISTS ] <name> SET
  [ APPEND_ONLY = TRUE | FALSE ]
  [ INSERT_ONLY = TRUE ]
  [ TAG <tag_key> = '<tag_value>' [ , <tag_key> = '<tag_value>' ... ] ]
  [ COMMENT = '<string_literal>' ]

ALTER STREAM [ IF EXISTS ] <name> SET TAG <tag_name> = '<tag_value>' [ , <tag_name> = '<tag_value>' ... ]

ALTER STREAM <name> UNSET TAG <tag_name> [ , <tag_name> ... ]

ALTER STREAM [ IF EXISTS ] <name> UNSET COMMENT

Parameter

Name

Bezeichner für den zu ändernden Stream. Wenn der Bezeichner Leerzeichen oder Sonderzeichen enthält, muss die gesamte Zeichenfolge in doppelte Anführungszeichen gesetzt werden. Bei Bezeichnern, die in doppelte Anführungszeichen eingeschlossen sind, ist auch die Groß- und Kleinschreibung zu beachten.

SET ...

Gibt die Eigenschaften an, die für den Stream festgelegt werden sollen:

APPEND_ONLY = TRUE | FALSE

Wird nur für Streams auf Standardtabellen oder Streams auf Ansichten, die Standardtabellen abfragen, unterstützt. Gibt an, ob es sich um einen Nur-Anfügen-Stream handelt. Bei Nur-Anfügen-Streams werden nur Zeileneinfügungen verfolgt. Aktualisierungs- und Löschoperationen (einschließlich Tabellenkürzungen) werden nicht aufgezeichnet. Wenn beispielsweise 10 Zeilen in eine Tabelle eingefügt werden und dann 5 dieser Zeilen gelöscht werden, bevor der Offset für einen Nur-Anfügen-Stream erweitert wird, zeichnet der Stream 10 Zeilen auf.

Diese Art von Stream verbessert die Abfrageleistung gegenüber Standardstreams und ist sehr nützlich für das Extrahieren, Laden, Transformieren (ELT) und ähnliche Szenarien, die ausschließlich von Zeileneinfügungen abhängen.

Ein Standardstream verknüpft die gelöschten und eingefügten Zeilen im Änderungsset, um zu bestimmen, welche Zeilen gelöscht und welche aktualisiert wurden. Ein Nur-Anfügen-Stream gibt nur die angefügten Zeilen zurück und kann daher viel leistungsfähiger als ein Standardstream sein. Beispiel: Die Quelltabelle kann unmittelbar nach dem Verarbeiten der Zeilen eines Nur-Anfügen-Streams abgeschnitten werden, und das Löschen von Datensätzen produziert keinen Overhead, wenn der Stream das nächste Mal abgefragt oder verarbeitet wird.

Bemerkung

  • Wenn weder APPEND_ONLY noch INSERT_ONLY gesetzt sind oder auf FALSE gesetzt sind, handelt es sich um einen Standard-Stream (Delta-Stream).

  • In einem Stream kann entweder APPEND_ONLY oder INSERT_ONLY auf TRUE gesetzt sein, aber nicht beide. Der Typ des Streams kann jederzeit geändert werden.

INSERT_ONLY = TRUE | FALSE

Wird nur für externe Tabellen unterstützt. Gibt an, ob es sich um einen Nur-Einfügen-Stream handelt. Bei Nur-Einfügen-Streams werden nur Zeileneinfügungen verfolgt. Löschoperationen, bei denen Zeilen aus einem eingefügten Set entfernt werden, werden nicht erfasst (d. h. NoOps). Wenn beispielsweise zwischen zwei beliebigen Offsets „File1“ aus dem Cloudspeicherort entfernt wird, auf den in der externen Tabelle verwiesen wird, und „File2“ hinzugefügt wird, gibt der Stream nur Datensätze für die Zeilen in „File2“ zurück. Im Gegensatz zur Verfolgung von CDC-Daten für Standardtabellen kann Snowflake nicht auf die historischen Datensätze von Dateien im Cloudspeicher zugreifen.

Bemerkung

  • Wenn weder APPEND_ONLY noch INSERT_ONLY gesetzt sind oder auf FALSE gesetzt sind, handelt es sich um einen Standard-Stream (Delta-Stream).

  • In einem Stream kann entweder APPEND_ONLY oder INSERT_ONLY auf TRUE gesetzt sein, aber nicht beide. Der Typ des Streams kann jederzeit geändert werden.

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.

COMMENT = 'Zeichenfolge'

Fügt einen Kommentar hinzu oder überschreibt einen vorhandenen Kommentar für den Stream.

UNSET ...

Gibt eine oder mehrere Eigenschaften/Parameter an, die für Streams nicht festgelegt werden sollen, wodurch sie auf ihre Standardwerte zurückgesetzt werden:

  • APPEND_ONLY

  • INSERT_ONLY

  • TAG Tag-Schlüssel [ , Tag-Schlüssel ... ]

  • COMMENT

Nutzungshinweise

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.

Beispiele

Fügen Sie einen Kommentar für einen Stream hinzu:

ALTER STREAM mystream SET COMMENT = 'New comment for stream';