カテゴリ：

データパイプライン DDL

ALTER STREAM

既存のストリームのプロパティ、列、または制約を変更します。

こちらもご参照ください。

CREATE STREAM、 DROP STREAM、 SHOW STREAMS、 DESCRIBE STREAM

このトピックの内容:

構文

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

パラメーター

名前

変更するストリームの識別子。識別子にスペースまたは特殊文字が含まれる場合、文字列全体を二重引用符で囲む必要があります。二重引用符で囲まれた識別子も大文字と小文字が区別されます。

SET ...

ストリームに設定するプロパティを指定します。

APPEND_ONLY = TRUE | FALSE

標準テーブルのみをクエリする、標準テーブルのストリームまたはビューのストリームのみがサポートされます。 これが追加専用ストリームであるかどうかを指定します。追加専用ストリームは、行の挿入のみを追跡します。更新および削除操作（テーブルの切り捨てを含む）は記録されません。例えば、10行がテーブルに挿入され、追加専用ストリームのオフセットが進む前にそれらの行の5が削除された場合、ストリームは10行を記録します。

このタイプのストリームは、標準ストリームよりもクエリのパフォーマンスを向上させ、抽出、ロード、変換（ELT）および行挿入のみに依存する同様のシナリオに非常に役立ちます。

標準ストリームは、変更セット内の削除された行と挿入された行を結合して、削除された行と更新された行を判別します。追加専用ストリームは追加された行のみを返すため、標準ストリームよりもはるかにパフォーマンスが向上します。たとえば、追加専用ストリームの行が消費された直後にソーステーブルを切り捨てることができ、記録の削除は、次にストリームがクエリまたは消費されるときにオーバーヘッドに寄与しません。

注釈

  • APPEND_ONLY と INSERT_ONLY の両方が設定されていないか、 FALSE に設定されている場合、ストリームは標準（デルタ）ストリームです。

  • ストリームでは、 APPEND_ONLY または INSERT_ONLY の いずれか を TRUE に設定できますが、両方には設定できません。ストリーム型はいつでも変更できます。

INSERT_ONLY = TRUE | FALSE

外部テーブルでのみサポートされます。 これが挿入専用ストリームかどうかを指定します。挿入専用ストリームは、行の挿入のみを追跡します。挿入されたセットから行を削除する削除操作は記録されません（つまり、操作なし）。例えば、任意の2つのオフセットの間で、外部テーブルによって参照されるクラウドストレージの場所からFile1が削除され、File2が追加された場合、ストリームはFile2の行のレコードのみを返します。標準テーブルの CDC データを追跡する場合とは異なり、Snowflakeはクラウドストレージ内のファイルの履歴記録にアクセスできません。

注釈

  • APPEND_ONLY と INSERT_ONLY の両方が設定されていないか、 FALSE に設定されている場合、ストリームは標準（デルタ）ストリームです。

  • ストリームでは、 APPEND_ONLY または INSERT_ONLY の いずれか を TRUE に設定できますが、両方には設定できません。ストリーム型はいつでも変更できます。

TAG タグ名 = 'タグ値' [ , タグ名 = 'タグ値' , ... ]

タグ 名（つまり、キー）とタグ値を指定します。

タグ値は常に文字列であり、タグ値の最大文字数は256です。オブジェクトに設定できる 一意の タグキーの最大数は20です。

COMMENT = '文字列'

ストリームのコメントを追加するか、既存のコメントを上書きします。

UNSET ...

ストリームの設定を解除する1つ以上のプロパティ/パラメーターを指定し、それらをデフォルトにリセットします。

  • APPEND_ONLY

  • INSERT_ONLY

  • TAG タグキー [ , タグキー ... ]

  • COMMENT

使用上の注意

メタデータについて。

注意

Snowflakeサービスを使用する場合、お客様は、個人データ（ユーザーオブジェクト向け以外）、機密データ、輸出管理データ、またはその他の規制されたデータがメタデータとして入力されていないことを確認する必要があります。詳細については、 Snowflakeのメタデータフィールド をご参照ください。

例

ストリームにコメントを追加します。

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