ALTER TABLE¶

構文¶

ALTER TABLE [ IF EXISTS ] <name> RENAME TO <new_table_name>

ALTER TABLE [ IF EXISTS ] <name> SWAP WITH <target_table_name>

ALTER TABLE [ IF EXISTS ] <name> { clusteringAction | tableColumnAction | constraintAction  }

ALTER TABLE [ IF EXISTS ] <name> dataGovnPolicyTagAction

ALTER TABLE [ IF EXISTS ] <name> extTableColumnAction

ALTER TABLE [ IF EXISTS ] <name> searchOptimizationAction

ALTER TABLE [ IF EXISTS ] <name> SET
  [ STAGE_FILE_FORMAT = ( { FORMAT_NAME = '<file_format_name>' | TYPE = { CSV | JSON | AVRO | ORC | PARQUET | XML } [ formatTypeOptions ] } ) ]
  [ STAGE_COPY_OPTIONS = ( copyOptions ) ]
  [ DATA_RETENTION_TIME_IN_DAYS = <integer> ]
  [ MAX_DATA_EXTENSION_TIME_IN_DAYS = <integer> ]
  [ CHANGE_TRACKING = { TRUE | FALSE  } ]
  [ DEFAULT_DDL_COLLATION = '<collation_specification>' ]
  [ ENABLE_SCHEMA_EVOLUTION = { TRUE | FALSE } ]
  [ COMMENT = '<string_literal>' ]

ALTER TABLE [ IF EXISTS ] <name> UNSET {
                                       DATA_RETENTION_TIME_IN_DAYS         |
                                       MAX_DATA_EXTENSION_TIME_IN_DAYS     |
                                       CHANGE_TRACKING                     |
                                       DEFAULT_DDL_COLLATION               |
                                       ENABLE_SCHEMA_EVOLUTION             |
                                       COMMENT                             |
                                       }
                                       [ , ... ]

条件:

clusteringAction ::=
  {
     CLUSTER BY ( <expr> [ , <expr> , ... ] )
     /* RECLUSTER is deprecated */
   | RECLUSTER [ MAX_SIZE = <budget_in_bytes> ] [ WHERE <condition> ]
     /* { SUSPEND | RESUME } RECLUSTER is valid action */
   | { SUSPEND | RESUME } RECLUSTER
   | DROP CLUSTERING KEY
  }

Copy

tableColumnAction ::=
  {
     ADD [ COLUMN ] [ IF NOT EXISTS ] <col_name> <col_type>
        [
           {
              DEFAULT <default_value>
              | { AUTOINCREMENT | IDENTITY }
                 /* AUTOINCREMENT (or IDENTITY) is supported only for           */
                 /* columns with numeric data types (NUMBER, INT, FLOAT, etc.). */
                 /* Also, if the table is not empty (i.e. if the table contains */
                 /* any rows), only DEFAULT can be altered.                     */
                 [
                    {
                       ( <start_num> , <step_num> )
                       | START <num> INCREMENT <num>
                    }
                 ]
                 [  { ORDER | NOORDER } ]
           }
        ]
        [ inlineConstraint ]
        [ COLLATE '<collation_specification>' ]

   | RENAME COLUMN <col_name> TO <new_col_name>

   | ALTER | MODIFY [ ( ]
                            [ COLUMN ] <col1_name> DROP DEFAULT
                          , [ COLUMN ] <col1_name> SET DEFAULT <seq_name>.NEXTVAL
                          , [ COLUMN ] <col1_name> { [ SET ] NOT NULL | DROP NOT NULL }
                          , [ COLUMN ] <col1_name> [ [ SET DATA ] TYPE ] <type>
                          , [ COLUMN ] <col1_name> COMMENT '<string>'
                          , [ COLUMN ] <col1_name> UNSET COMMENT
                        [ , [ COLUMN ] <col2_name> ... ]
                        [ , ... ]
                    [ ) ]

   | DROP [ COLUMN ] [ IF EXISTS ] <col1_name> [, <col2_name> ... ]
  }

  inlineConstraint ::=
    [ NOT NULL ]
    [ CONSTRAINT <constraint_name> ]
    { UNIQUE | PRIMARY KEY | { [ FOREIGN KEY ] REFERENCES <ref_table_name> [ ( <ref_col_name> ) ] } }
    [ <constraint_properties> ]

Copy

列を変更するための詳細な構文と例については、 ALTER TABLE ... ALTER COLUMN をご参照ください。 .

インライン制約を作成/変更するための詳細な構文と例については、 CREATE | ALTER TABLE ... CONSTRAINT をご参照ください。

dataGovnPolicyTagAction ::=
  {
      SET TAG <tag_name> = '<tag_value>' [ , <tag_name> = '<tag_value>' ... ]
    | UNSET TAG <tag_name> [ , <tag_name> ... ]
  }
  |
  {
      ADD ROW ACCESS POLICY <policy_name> ON ( <col_name> [ , ... ] )
    | DROP ROW ACCESS POLICY <policy_name>
    | DROP ROW ACCESS POLICY <policy_name> ,
        ADD ROW ACCESS POLICY <policy_name> ON ( <col_name> [ , ... ] )
    | DROP ALL ROW ACCESS POLICIES
  }
  |
  {
      SET AGGREGATION POLICY <policy_name> [ FORCE ]
      | UNSET AGGREGATION POLICY
  }
  |
  ADD [ COLUMN ] [ IF NOT EXISTS ] <col_name> <col_type>
    [ [ WITH ] MASKING POLICY <policy_name>
          [ USING ( <col1_name> , <cond_col_1> , ... ) ] ]
    [ [ WITH ] TAG ( <tag_name> = '<tag_value>'
          [ , <tag_name> = '<tag_value>' , ... ] ) ]
  |
  {
    { ALTER | MODIFY } [ COLUMN ] <col1_name>
        SET MASKING POLICY <policy_name>
          [ USING ( <col1_name> , <cond_col_1> , ... ) ] [ FORCE ]
      | UNSET MASKING POLICY
  }
  |
  {
    { ALTER | MODIFY } [ COLUMN ] <col1_name>
        SET PROJECTION POLICY <policy_name>
          [ FORCE ]
      | UNSET PROJECTION POLICY
  }
  |
  { ALTER | MODIFY } [ COLUMN ] <col1_name> SET TAG
      <tag_name> = '<tag_value>' [ , <tag_name> = '<tag_value>' ... ]
      , [ COLUMN ] <col2_name> SET TAG
          <tag_name> = '<tag_value>' [ , <tag_name> = '<tag_value>' ... ]
  |
  { ALTER | MODIFY } [ COLUMN ] <col1_name> UNSET TAG <tag_name> [ , <tag_name> ... ]
                   , [ COLUMN ] <col2_name> UNSET TAG <tag_name> [ , <tag_name> ... ]

Copy

extTableColumnAction ::=
  {
     ADD [ COLUMN ] [ IF NOT EXISTS ] <col_name> <col_type> AS ( <expr> )

   | RENAME COLUMN <col_name> TO <new_col_name>

   | DROP [ COLUMN ] [ IF EXISTS ] <col1_name> [, <col2_name> ... ]
  }

Copy

constraintAction ::=
  {
     ADD outoflineConstraint
   | RENAME CONSTRAINT <constraint_name> TO <new_constraint_name>
   | { ALTER | MODIFY } { CONSTRAINT <constraint_name> | PRIMARY KEY | UNIQUE | FOREIGN KEY } ( <col_name> [ , ... ] )
                         [ [ NOT ] ENFORCED ] [ VALIDATE | NOVALIDATE ] [ RELY | NORELY ]
   | DROP { CONSTRAINT <constraint_name> | PRIMARY KEY | UNIQUE | FOREIGN KEY } ( <col_name> [ , ... ] )
                         [ CASCADE | RESTRICT ]
  }

  outoflineConstraint ::=
    [ CONSTRAINT <constraint_name> ]
    {
       UNIQUE [ ( <col_name> [ , <col_name> , ... ] ) ]
     | PRIMARY KEY [ ( <col_name> [ , <col_name> , ... ] ) ]
     | [ FOREIGN KEY ] [ ( <col_name> [ , <col_name> , ... ] ) ]
                          REFERENCES <ref_table_name> [ ( <ref_col_name> [ , <ref_col_name> , ... ] ) ]
    }
    [ <constraint_properties> ]

Copy

アウトライン制約の作成/変更の詳細な構文と例については、 CREATE | ALTER TABLE ... CONSTRAINT をご参照ください。

searchOptimizationAction ::=
  {
     ADD SEARCH OPTIMIZATION [
       ON <search_method_with_target> [ , <search_method_with_target> ... ]
     ]

   | DROP SEARCH OPTIMIZATION [
       ON { <search_method_with_target> | <column_name> | <expression_id> }
          [ , ... ]
     ]

  }

Copy

詳細については、 検索最適化アクション（ searchOptimizationAction） をご参照ください。

formatTypeOptions ::=
-- If TYPE = CSV
     COMPRESSION = AUTO | GZIP | BZ2 | BROTLI | ZSTD | DEFLATE | RAW_DEFLATE | NONE
     RECORD_DELIMITER = '<character>' | NONE
     FIELD_DELIMITER = '<character>' | NONE
     FILE_EXTENSION = '<string>'
     PARSE_HEADER = TRUE | FALSE
     SKIP_HEADER = <integer>
     SKIP_BLANK_LINES = TRUE | FALSE
     DATE_FORMAT = '<string>' | AUTO
     TIME_FORMAT = '<string>' | AUTO
     TIMESTAMP_FORMAT = '<string>' | AUTO
     BINARY_FORMAT = HEX | BASE64 | UTF8
     ESCAPE = '<character>' | NONE
     ESCAPE_UNENCLOSED_FIELD = '<character>' | NONE
     TRIM_SPACE = TRUE | FALSE
     FIELD_OPTIONALLY_ENCLOSED_BY = '<character>' | NONE
     NULL_IF = ( '<string>' [ , '<string>' ... ] )
     ERROR_ON_COLUMN_COUNT_MISMATCH = TRUE | FALSE
     REPLACE_INVALID_CHARACTERS = TRUE | FALSE
     EMPTY_FIELD_AS_NULL = TRUE | FALSE
     SKIP_BYTE_ORDER_MARK = TRUE | FALSE
     ENCODING = '<string>' | UTF8
-- If TYPE = JSON
     COMPRESSION = AUTO | GZIP | BZ2 | BROTLI | ZSTD | DEFLATE | RAW_DEFLATE | NONE
     DATE_FORMAT = '<string>' | AUTO
     TIME_FORMAT = '<string>' | AUTO
     TIMESTAMP_FORMAT = '<string>' | AUTO
     BINARY_FORMAT = HEX | BASE64 | UTF8
     TRIM_SPACE = TRUE | FALSE
     NULL_IF = ( '<string>' [ , '<string>' ... ] )
     FILE_EXTENSION = '<string>'
     ENABLE_OCTAL = TRUE | FALSE
     ALLOW_DUPLICATE = TRUE | FALSE
     STRIP_OUTER_ARRAY = TRUE | FALSE
     STRIP_NULL_VALUES = TRUE | FALSE
     REPLACE_INVALID_CHARACTERS = TRUE | FALSE
     IGNORE_UTF8_ERRORS = TRUE | FALSE
     SKIP_BYTE_ORDER_MARK = TRUE | FALSE
-- If TYPE = AVRO
     COMPRESSION = AUTO | GZIP | BROTLI | ZSTD | DEFLATE | RAW_DEFLATE | NONE
     TRIM_SPACE = TRUE | FALSE
     REPLACE_INVALID_CHARACTERS = TRUE | FALSE
     NULL_IF = ( '<string>' [ , '<string>' ... ] )
-- If TYPE = ORC
     TRIM_SPACE = TRUE | FALSE
     REPLACE_INVALID_CHARACTERS = TRUE | FALSE
     NULL_IF = ( '<string>' [ , '<string>' ... ] )
-- If TYPE = PARQUET
     COMPRESSION = AUTO | LZO | SNAPPY | NONE
     SNAPPY_COMPRESSION = TRUE | FALSE
     BINARY_AS_TEXT = TRUE | FALSE
     USE_LOGICAL_TYPE = TRUE | FALSE
     TRIM_SPACE = TRUE | FALSE
     REPLACE_INVALID_CHARACTERS = TRUE | FALSE
     NULL_IF = ( '<string>' [ , '<string>' ... ] )
-- If TYPE = XML
     COMPRESSION = AUTO | GZIP | BZ2 | BROTLI | ZSTD | DEFLATE | RAW_DEFLATE | NONE
     IGNORE_UTF8_ERRORS = TRUE | FALSE
     PRESERVE_SPACE = TRUE | FALSE
     STRIP_OUTER_ELEMENT = TRUE | FALSE
     DISABLE_SNOWFLAKE_DATA = TRUE | FALSE
     DISABLE_AUTO_CONVERT = TRUE | FALSE
     REPLACE_INVALID_CHARACTERS = TRUE | FALSE
     SKIP_BYTE_ORDER_MARK = TRUE | FALSE

Copy

copyOptions ::=
     ON_ERROR = { CONTINUE | SKIP_FILE | SKIP_FILE_<num> | 'SKIP_FILE_<num>%' | ABORT_STATEMENT }
     SIZE_LIMIT = <num>
     PURGE = TRUE | FALSE
     RETURN_FAILED_ONLY = TRUE | FALSE
     MATCH_BY_COLUMN_NAME = CASE_SENSITIVE | CASE_INSENSITIVE | NONE
     ENFORCE_LENGTH = TRUE | FALSE
     TRUNCATECOLUMNS = TRUE | FALSE
     FORCE = TRUE | FALSE

Copy

パラメーター¶

name

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

RENAME TO new_table_name

指定されたテーブルの名前を、スキーマ内の他のテーブルで現在使用されていない新しい識別子に変更します。

テーブル識別子の詳細については、 識別子の要件 をご参照ください。

オプションでオブジェクトの名前を変更して、オブジェクトを別のデータベースやスキーマに移動できます。これを実行するには、新しいデータベース名やスキーマ名をそれぞれ db_name.schema_name.object_name または schema_name.object_name の形式で含む、修飾された new_name 値を指定します。

注釈

• 宛先データベースやスキーマはすでに存在している必要があります。また、同じ名前のオブジェクトが宛先データベースにすでに存在することはできません。存在する場合、ステートメントはエラーを返します。

• オブジェクトを管理アクセススキーマに移動することは、オブジェクトの所有者（つまり、オブジェクトに対して OWNERSHIP 権限を持つロール）がターゲットスキーマも所有している場合を 除き 禁止されています。

オブジェクト（テーブル、列など）の名前が変更されると、それを参照する他のオブジェクトも新しい名前で更新する必要があります。

SWAP WITH target_table_name

スワップは、1つのトランザクションで2つのテーブルの名前を変更します。

永続テーブルまたは一時テーブルを、作成されたユーザーセッションの期間のみ存続する仮テーブルと交換することは許可されていないことに注意してください。この制限により、仮テーブルが永続テーブルまたは一時テーブルと交換され、既存の永続テーブルまたは一時テーブルの名前が、仮テーブルと同じになった場合に発生する可能性のある名前の競合が防止されます。永続テーブルまたは一時テーブルを仮テーブルと交換するには、3つの ALTER TABLE ... RENAME TO ステートメントを使用します。テーブル名を a から c に、 b から a に、そして c から b に変更します。

SET ...

テーブルに設定する1つ以上のプロパティ/パラメーターを指定します（空白、コンマ、または改行で区切られます）。

STAGE_FILE_FORMAT = ( FORMAT_NAME = 'file_format_name' ) または . STAGE_FILE_FORMAT = ( TYPE = CSV | JSON | AVRO | ORC | PARQUET | XML [ ... ] )

テーブルのデフォルトファイル形式を次のいずれかに変更します（データのロードおよびアンロード用）。

FORMAT_NAME = file_format_name

データのロード/アンロードに使用する既存のファイル形式オブジェクトを指定します。指定されたファイル形式オブジェクトは、データファイルの形式タイプ（CSV、 JSONなど）およびその他の形式オプションを決定します。

文字列には追加の形式オプションが指定されていないことに注意してください。代わりに、名前付きファイル形式オブジェクトは、データのロード/アンロードに使用される他のファイル形式オプションを定義します。詳細については、 CREATE FILE FORMAT をご参照ください。

TYPE = CSV | JSON | AVRO | ORC | PARQUET | XML [ ... ]

ロード/アンロードするファイルのタイプを指定します。追加の形式固有オプションを文字列に含めることができます。詳細については、 形式タイプオプション （このトピック）をご参照ください。

注釈

FORMAT_NAME と TYPE は相互に排他的です。テーブルにはどちらか一方しか指定できません。

STAGE_COPY_OPTIONS = ( ... )

ファイルからテーブルにデータをロードするときに使用するコピーオプションを変更します。詳細については、 コピーオプション （このトピック内）をご参照ください。

DATA_RETENTION_TIME_IN_DAYS = integer

Time Travelのテーブルの保持期間を変更するオブジェクトレベルのパラメーター。詳細については、 Time Travelの理解と使用 および 仮テーブルと一時テーブルの使用 をご参照ください。

このパラメーターの詳細な説明、およびオブジェクトパラメーターの詳細については、 パラメーター をご参照ください。

値：

• Standard Edition： 0 または 1

• Enterprise Edition:

  • 永続テーブルの場合は 0 ～ 90

  • 仮および一時テーブルの場合は 0 または 1

注釈

0 の値は、テーブルのTime Travelを効果的に無効化します。

MAX_DATA_EXTENSION_TIME_IN_DAYS = integer

Snowflakeがテーブルのデータ保持期間を延長してテーブル上のストリームが古くなるのを防ぐことができる最大日数を指定するオブジェクトパラメーター。

このパラメーターの詳細については、 MAX_DATA_EXTENSION_TIME_IN_DAYS をご参照ください。

CHANGE_TRACKING = TRUE | FALSE

テーブルの変更追跡を有効または無効にするように指定します。

• TRUE テーブルの変更追跡を有効にします。このオプションは、複数の非表示の列をソーステーブルに追加し、列に変更追跡メタデータを保存し始めます。これらの列は少量のストレージを消費します。

  変更追跡メタデータのクエリには、 SELECT ステートメントの CHANGES 句を使用するか、テーブルで1つ以上のストリームを作成し、クエリします。

• FALSE テーブルの変更追跡を無効にします。関連する非表示列はテーブルから削除されます。

DEFAULT_DDL_COLLATION = 'collation_specification'

テーブルに追加された新しい列のデフォルトの 照合順序仕様 を指定します。

パラメーターを設定しても、既存の列の照合順序仕様は 変更されません 。

パラメーターの詳細については、 DEFAULT_DDL_COLLATION をご参照ください。

ENABLE_SCHEMA_EVOLUTION = { TRUE | FALSE }

以下を含むソースファイルから、テーブルにロードされたデータからのテーブルスキーマを自動的に変更することを有効または無効にします。

• 追加された列。

  デフォルトでは、スキーマ進化は、ロード操作ごとに最大10列の追加された列に制限されています。1回のロード操作で10列を超えるの列の追加をリクエストする場合は、 Snowflakeサポート にお問い合わせください。

• NOT NULL 制約は、新しいデータファイルで欠落しているいくつの列からでもドロップすることができます。

TRUE に設定すると、自動テーブルスキーマ進化が有効になります。デフォルトの FALSE は、自動テーブルスキーマ進化を無効にします。

注釈

ファイルからのデータのロードでテーブル列が進化するのは、次のすべてが当てはまる場合です。

• COPY INTO <テーブル> ステートメントには MATCH_BY_COLUMN_NAME オプションが含まれる。

• データのロードに使用されるロールは、テーブルに対する EVOLVE SCHEMA または OWNERSHIP の権限を持っている。

さらに、 CSV でスキーマを進化させる際に、 MATCH_BY_COLUMN_NAME と PARSE_HEADER を使用する場合は、 ERROR_ON_COLUMN_COUNT_MISMATCH をfalseに設定する必要があります。

COMMENT = 'string_literal'

テーブルのコメントを追加するか、既存のコメントを上書きします。

UNSET ...

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

• DATA_RETENTION_TIME_IN_DAYS

• MAX_DATA_EXTENSION_TIME_IN_DAYS

• CHANGE_TRACKING

• DEFAULT_DDL_COLLATION

• ENABLE_SCHEMA_EVOLUTION

• COMMENT

クラスタリングアクション（clusteringAction）¶

CLUSTER BY ( expr [ , expr , ... ] )

1つ以上のテーブル列または列式をテーブルのクラスタリングキーとして指定（または変更）します。これらは、自動クラスタリングによってクラスタリングが維持される列/式です。

重要

クラスタリングキーは、すべてのテーブルに対して意図または推奨されて いません。通常、非常に大きな（つまり、マルチテラバイト）テーブルに役立ちます。

テーブルのクラスタリングキーを指定する前に、 Snowflakeテーブル構造について をご参照ください。

RECLUSTER ...

非推奨

クラスタリングキーが定義されているテーブルの手動の増分再クラスタリングを実行します。

MAX_SIZE = budget_in_bytes

非推奨 --- より大きなウェアハウスを使用して、より効果的な手動再クラスタリングを実現します

再クラスタ化するテーブルのデータ量の上限（バイト単位）を指定します。

WHERE condition

テーブル内のデータを再クラスター化する条件または範囲を指定します。

注釈

テーブルに対して OWNERSHIP または INSERT 権限を持つロールのみがテーブルを再クラスター化できます。

SUSPEND | RESUME RECLUSTER

テーブルの 自動クラスタリング を有効または無効にします。

DROP CLUSTERING KEY

テーブルのクラスタリングキーをドロップします。

クラスタリングキーと再クラスタリングの詳細については、 Snowflakeテーブル構造について をご参照ください。

テーブル列アクション（tableColumnAction）¶

ADD [ COLUMN ] [ IF NOT EXISTS ] col_name col_data_type . [ DEFAULT default_value | AUTOINCREMENT ... ] . [ inlineConstraint ] [ COLLATE 'collation_specification' ] . [ [ WITH ] MASKING POLICY policy_name ] . [ [ WITH ] PROJECTION POLICY policy_name ] . [ [ WITH ] TAG ( tag_name = 'tag_value' [ , tag_name = 'tag_value' , ... ] ) ] [ , ...]

新しい列を追加します。デフォルト値、インライン制約、 照合順序仕様、マスキングポリシー、および/または1つ以上のタグを指定できます。

追加している列のデフォルト値はリテラル値でなければなりません。式や関数が返す値にはできません。例えば、次のコマンドは予期されるエラーを返します。

ALTER TABLE t1 ADD COLUMN c5 VARCHAR DEFAULT 12345::VARCHAR;

Copy

002263 (22000): SQL compilation error:
Invalid column default expression [CAST(12345 AS VARCHAR(16777216))]

最初にテーブルを作成する際には、デフォルト値として式を使用できますが、列を追加する際には使用できません。

列のデフォルト値は、列のデータ型と一致する必要があります。データ型が一致しないデフォルト値を設定しようとすると、エラーで失敗します。例:

ALTER TABLE t1 ADD COLUMN c6 DATE DEFAULT '20230101';

Copy

002023 (22000): SQL compilation error:
Expression type does not match column data type, expecting DATE but got VARCHAR(8) for column C6

テーブル列アクションの詳細については、次をご参照ください。

• CREATE TABLE

• CREATE | ALTER TABLE ... CONSTRAINT

• CREATE MASKING POLICY

• CREATE TAG

ADD COLUMN 操作は、同じコマンドにある複数の列で実行できます。

列がすでに存在するかどうかわからない場合は、列を追加する際に IF NOT EXISTS を指定できます。列がすでに存在する場合、 ADD COLUMN が既存の列に影響を与えることはなく、エラーにはなりません。

注釈

新しい列に次のいずれかも指定する場合は、 IF NOT EXISTS を指定できません。

• DEFAULT 、 AUTOINCREMENT 、または IDENTITY

• UNIQUE、 PRIMARY KEY、または FOREIGN KEY

RENAME COLUMN col_name to new_col_name

指定した列の名前を、テーブル内の他の列に現在使用されていない新しい名前に変更します。

クラスタリングキーの一部である列の名前を変更することはできません。

オブジェクト（テーブル、列など）の名前が変更されると、それを参照する他のオブジェクトも新しい名前で更新する必要があります。

DROP COLUMN [ IF EXISTS ] col_name [ CASCADE | RESTRICT ]

指定した列をテーブルから削除します。

列がすでに存在するかどうかわからない場合は、列をドロップする際に IF EXISTS を指定できます。列が存在しない場合、 DROP COLUMN は何の影響もなく、エラーにもなりません。

列のドロップは、メタデータのみの操作です。マイクロパーティションはすぐには書き換えられないため、列で使用されているスペースはすぐには解放されません。通常、個々のマイクロパーティション内のスペースは、次にマイクロパーティションが再書き込みされるときに解放されます。これは通常、 DML （INSERT、 UPDATE、 DELETE）または再クラスタリングによって書き込みが完了した時点です。

外部テーブル列アクション（extTableColumnAction）¶

他のすべての外部テーブル変更については、 ALTER EXTERNAL TABLE をご参照ください。

ADD [ COLUMN ] [ IF NOT EXISTS ] <col_name> <col_type> AS ( <expr> ) [, ...]

新しい列を外部テーブルに追加します。

列がすでに存在するかどうかわからない場合は、列を追加する際に IF NOT EXISTS を指定できます。列がすでに存在する場合、 ADD COLUMN が既存の列に影響を与えることはなく、エラーにはなりません。

この操作は、同じコマンドにある複数の列で実行できます。

col_name

列識別子（名前）を指定する文字列。テーブル識別子のすべての要件は、列識別子にも適用されます。

詳細については、 識別子の要件 をご参照ください。

col_type

列のデータ型を指定する文字列（定数）。データ型は、列の expr の結果と一致する必要があります。

テーブル列に指定できるデータ型の詳細については、 SQL データ型リファレンス をご参照ください。

expr

列の式を指定する文字列。クエリすると、列はこの式から派生した結果を返します。

外部テーブルの列は、明示的な式を使用して定義される仮想列です。VALUE 列および/または METADATA$FILENAME 疑似列を使用し、式として仮想列を追加します。

VALUE:

外部ファイルの単一の行を表す VARIANT 型の列。

CSV:

VALUE 列は、各行を、列の位置（つまり、 {c1: <列1の値>, c2: <列2の値>, c3: <列1の値> ...}）で識別される要素を持つオブジェクトとして構成します。

たとえば、ステージングされた CSV ファイル内の最初の列を参照する mycol という名前の VARCHAR 列を追加します。

mycol varchar as (value:c1::varchar)

Copy

半構造化データ:

要素の名前と値を二重引用符で囲みます。ドット表記を使用して、 VALUE 列のパスを走査します。

たとえば、次がステージングされたファイル内の半構造化データの単一行を表すとします。

{ "a":"1", "b": { "c":"2", "d":"3" } }

Copy

ステージングされたファイル内のネストされた繰り返し c 要素を参照する mycol という名前の VARCHAR 列を追加します。

mycol varchar as (value:"b"."c"::varchar)

Copy

METADATA$FILENAME:

外部テーブルに含まれるステージングされた各データファイルの名前を識別する疑似列。ステージ内のパスも含まれます。

RENAME COLUMN col_name to new_col_name

外部テーブル内の他の列で現在使用されていない新しい名前に、指定した列の名前を変更します。

DROP COLUMN [ IF EXISTS ] col_name

指定した列を外部テーブルから削除します。

列がすでに存在するかどうかわからない場合は、列をドロップする際に IF EXISTS を指定できます。列が存在しない場合、 DROP COLUMN は何の影響もなく、エラーにもなりません。

制約アクション（constraintAction）¶

ADD CONSTRAINT

テーブルの1つ以上の列にアウトラインの整合性制約を追加します。（列の）インライン制約を追加するには、 列アクション （このトピック）をご参照ください。

RENAME CONSTRAINT constraint_name TO new_constraint_name

指定された制約の名前を変更します。

ALTER | MODIFY CONSTRAINT ...

指定された制約のプロパティを変更します。

DROP CONSTRAINT constraint_name | PRIMARY KEY | UNIQUE | FOREIGN KEY ( col_name [ , ... ] ) [ CASCADE | RESTRICT ]

指定した列または列セットの指定した制約をドロップします。

制約を追加または変更するための詳細な構文と例については、 CREATE | ALTER TABLE ... CONSTRAINT をご参照ください。

データガバナンス方針とタグアクション（dataGovnPolicyTagAction）¶

TAG tag_name = 'tag_value' [ , tag_name = 'tag_value' , ... ]

タグ の名前とタグ文字列の値を指定します。

タグ値は常に文字列であり、タグ値の最大文字数は256です。

ステートメントでのタグの指定に関する情報については、 オブジェクトおよび列のタグクォータ をご参照ください。

policy_name

ポリシーの識別子。スキーマに対して一意である必要があります。

以下の句は、テーブル、ビュー、イベントテーブルなど、行アクセスポリシーをサポートするすべての種類のテーブルに適用されます。簡略化するために、句は単に「テーブル」を指しています。

ADD ROW ACCESS POLICY policy_name ON (col_name [ , ... ])

行アクセスポリシーをテーブルに追加します。

少なくとも1つの列名を指定する必要があります。追加の列は、各列名をコンマで区切って指定できます。この式を使用して、イベントテーブルと外部テーブルの両方に行アクセスポリシーを追加します。

DROP ROW ACCESS POLICY policy_name

テーブルから行アクセスポリシーをドロップします。

テーブルからポリシーをドロップするには、この句を使用します。

DROP ROW ACCESS POLICY policy_name, ADD ROW ACCESS POLICY policy_name ON ( col_name [ , ... ] )

テーブルに設定されている行アクセスポリシーをドロップし、1つの SQL ステートメントで同じテーブルに行アクセスポリシーを追加します。

DROP ALL ROW ACCESS POLICIES

テーブルから すべて の行アクセスポリシーの関連付けをドロップします。

この式は、イベントテーブルからポリシーをドロップする 前に、スキーマから行アクセスポリシーをドロップするときに役立ちます。この式を使用して、テーブルから行アクセスポリシーの関連付けをドロップします。

SET AGGREGATION POLICY policy_name [ FORCE ]

テーブルに 集計ポリシー を割り当てます。既存の集計ポリシーを新しい集計ポリシーにアトミックに置き換えるには、オプションの FORCE パラメーターを使用します。

UNSET AGGREGATION POLICY

テーブルから集計ポリシーをデタッチします。

{ ALTER | MODIFY } [ COLUMN ] ...

USING ( col_name , cond_col_1 ... )

条件付きマスキングポリシー SQL 式に渡す引数を指定します。

リストの最初の列は、データをマスクまたはトークン化するポリシー条件の列を指定し、マスキングポリシーが設定されている列と一致する 必要 があります。

追加の列は、最初の列でクエリが実行されたときに、クエリ結果の各行のデータをマスクするかトークン化するかを決定するために評価する列を指定します。

USING 句が省略されている場合、Snowflakeは条件付きマスキングポリシーを通常の マスキングポリシー として扱います。

FORCE

単一のステートメント内で、列に現在設定されているマスキングまたは投影ポリシーを別のポリシーに置き換えます。

マスキングポリシーで FORCE キーワードを使用するには、 ALTER TABLE ステートメント（つまり STRING）内のポリシーの データ型 が、列に現在設定されているマスキングポリシーのデータ型（つまり STRING）と一致している必要があります。

現在列にマスキングポリシーが設定されていない場合は、このキーワードを指定しても効果はありません。

詳細については、 列のマスキングポリシーを置き換える または 投影ポリシーの置き換え をご参照ください。

検索最適化アクション（ searchOptimizationAction）¶

ADD SEARCH OPTIMIZATION

テーブル全体の、またはオプションの ON 句を指定した場合は特定の列の 検索最適化 を追加します。

注意:

• 特にテーブル内のデータが頻繁に変更される場合、検索最適化は維持にコストがかかる可能性があります。詳細については、 検索最適化のコスト見積もりおよび管理 をご参照ください。

• マテリアライズドビューに検索最適化を追加しようとすると、Snowflakeはエラーメッセージを返します。

ON search_method_with_target [, search_method_with_target ... ]

特定の列または VARIANT フィールド（テーブル全体ではなく）に対して検索最適化を構成することを指定します。

search_method_with_target には、次の構文の式を使用します。

<search_method>(<target> [, ...])

Copy

条件:

• search_method は、特定の型の述語に対するクエリを最適化する次の方法のいずれかを指定します。

  検索方法	説明
  EQUALITY	等価および IN 述語。
  SUBSTRING	部分文字列と正規表現に一致する述語（例: [ NOT ] LIKE、 [ NOT ] ILIKE、 [ NOT ] RLIKE、 REGEXP_LIKE など）
  GEO	GEOGRAPHY 型を使用する述語。

• target は、列、 VARIANT フィールド、またはアスタリスク（*）を指定します。

  search_method の値に応じて、次に挙げる型の列または VARIANT フィールドを指定できます。

  検索方法	サポートされるターゲット
  EQUALITY	VARIANTs 内のフィールドへのパスを含む、数値、文字列、バイナリ、および VARIANT データ型の列。 VARIANT フィールドを指定するには、 ドットまたはブラケット表記 （例: my_column:my_field_name.my_nested_field_name または my_column['my_field_name']['my_nested_field_name']）を使用します。フィールドへのコロン区切りのパスを使用することもできます（例： my_column:my_field_name:my_nested_field_name）。 VARIANT フィールドを指定すると、そのフィールドの下にネストされたすべてのフィールドに構成が適用されます。たとえば、 ON EQUALITY(src:a.b) を指定したとします。 この構成により、クエリ on src:a.b およびネストされたフィールド（例: src:a.b.c、 src:a.b.c.d など）を改善できます。 この構成は、 src:a.b プレフィックスを使用しないクエリ（例: src:a、 src:z など）には影響しません。
  SUBSTRING	VARIANTs のフィールドへのパスを含む、文字列または VARIANT データ型の列。 EQUALITY で説明したように、フィールドへのパスを指定します。ネストされたフィールドの検索も同様に改善されます。
  GEO	GEOGRAPHY データ型の列。

  テーブル内の該当するすべての列をターゲットとして指定するには、アスタリスク（*）を使用します。

  特定の検索方法に対して、アスタリスクと特定の列名の 両方 を指定することはできません。ただし、さまざまな検索方法でアスタリスクを指定できます。

  たとえば、次の式を指定できます。

  -- Allowed
  ON SUBSTRING(*)
  ON EQUALITY(*), SUBSTRING(*), GEO(*)
  

  Copy

  次の式は指定できません。

  -- Not allowed
  ON EQUALITY(*, c1)
  ON EQUALITY(c1, *)
  ON EQUALITY(v1:path, *)
  ON EQUALITY(c1), EQUALITY(*)
  

  Copy

ターゲットに複数の検索方法を指定するには、コンマを使用して後続の各メソッドとターゲットを区切ります。

ALTER TABLE t1 ADD SEARCH OPTIMIZATION ON EQUALITY(c1), EQUALITY(c2, c3);

Copy

同じテーブルに対して ALTER TABLE ... ADD SEARCH OPTIMIZATION ON ... コマンドを複数回実行すると、後続の各コマンドがテーブルの既存の構成に追加されます。たとえば、次のコマンドを実行するとします。

ALTER TABLE t1 ADD SEARCH OPTIMIZATION ON EQUALITY(c1, c2);
ALTER TABLE t1 ADD SEARCH OPTIMIZATION ON EQUALITY(c3, c4);

Copy

これにより、列c1、c2、c3、およびc4の等価述語がテーブルの構成に追加されます。これは、次のコマンドを実行するのと同じです。

ALTER TABLE t1 ADD SEARCH OPTIMIZATION ON EQUALITY(c1, c2, c3, c4);

Copy

例については、 特定の列に対する検索最適化の有効化 をご参照ください。

DROP SEARCH OPTIMIZATION

テーブル全体の、またはオプションの ON 句を指定した場合は特定の列から 検索最適化 を削除します。

注意:

• テーブルに検索最適化プロパティがある場合、テーブルをドロップしてからドロップを解除すると、検索最適化プロパティが保持されます。

• テーブルから検索最適化プロパティを削除した後に再度追加すると、最初に追加したときと同じコストがかかります。

ON search_method_with_target | column_name | expression_id [, ... ]

特定の列または VARIANT フィールド（テーブル全体の検索最適化をドロップするのではなく）の検索最適化構成をドロップすることを指定します。

ドロップする列構成を識別するには、次のいずれかを指定します。

• search_method_with_target には、1つ以上の特定のターゲット（列または VARIANT フィールド）のクエリを最適化する方法を指定します。 前に説明されている構文 を使用します。

• column_name には、検索最適化用に構成された列の名前を指定します。列名を指定すると、その列の VARIANT フィールドを使用する式を含む、その列のすべての式がドロップされます。

• expression_id には、 DESCRIBE SEARCH OPTIMIZATION コマンドの出力にリストされた式の ID を指定します。

これらを複数指定するには、項目間にコンマを使用します。

ターゲット、列名、および式 IDs を使用して、検索方法を自由に組み合わせて指定できます。

例については、 特定の列に対する検索最適化のドロップ をご参照ください。

形式の種類のオプション（formatTypeOptions）¶

形式タイプオプションは、 テーブルへのデータのロード と テーブルからのデータのアンロード に使用されます。

指定したファイル形式タイプ（STAGE_FILE_FORMAT = ( TYPE = ... )）に応じて、次の形式固有のオプションを1つ以上含めることができます（空白、コンマ、または改行で区切られます）。

コピーオプション（copyOptions）¶

コピーオプションは、 テーブルへのデータのロード と テーブルからのデータのアンロード に使用されます。

次のコピーオプションを1つ以上指定できます（空白、コンマ、または改行で区切り）。

ON_ERROR = CONTINUE | SKIP_FILE | SKIP_FILE_num | 'SKIP_FILE_num%' | ABORT_STATEMENT

使用:

データのロードのみ

定義:

ロード操作のエラー処理を指定する文字列（定数）。

重要

ON_ERROR コピーオプションの値を慎重に検討してください。デフォルト値は一般的なシナリオでは適切ですが、常に最良のオプションであるとは限りません。

値:

• CONTINUE

  エラーが見つかった場合は、ファイルのロードを続行します。COPY ステートメントは、データファイルごとに見つかった最大1つのエラーのエラーメッセージを返します。

  ROWS_PARSED 列の値と ROWS_LOADED 列の値の差は、検出されたエラーを含む行の数を表します。ただし、これらの各行には複数のエラーが含まれる可能性があります。データファイルのすべてのエラーを表示するには、 VALIDATION_MODE パラメーターを使用するか、 VALIDATE 関数をクエリします。

• SKIP_FILE

  エラーが見つかった場合はファイルをスキップします。

  SKIP_FILE アクションは、エラーが見つかったかどうかに関係なく、ファイル全体をバッファーすることに注意してください。このため、 SKIP_FILE は CONTINUE または ABORT_STATEMENT よりも低速です。少数のエラーで大型のファイルをスキップすると、遅延が発生し、クレジットが無駄になる可能性があります。論理的な叙述がないファイルから多数の記録をロードする場合（例: ファイルが大まかな間隔で自動的に生成された場合）は、代わりに CONTINUE を指定することを検討してください。

  その他のパターン:

  SKIP_FILE_num （例: SKIP_FILE_10）

  ファイル内で見つかったエラー行の数が指定された数以上の場合は、ファイルをスキップします。

  'SKIP_FILE_num%' （例: 'SKIP_FILE_10%'）

  ファイル内で見つかったエラー行の割合が指定された割合を超えた場合は、ファイルをスキップします。

• ABORT_STATEMENT

  データファイルにエラーが見つかった場合は、ロード操作を中止します。

  データファイルが見つからない（例: データファイルが存在しない、またはデータファイルにアクセスできないため）場合は、 FILES パラメーターでデータファイルが見つからない場合を明示的に指定していたときを除いて、ロード操作は中止 されません。

デフォルト:

COPY を使用した一括ロード:

ABORT_STATEMENT

Snowpipe:

SKIP_FILE

SIZE_LIMIT = num

使用:

データのロードのみ

定義:

特定の COPY ステートメントに対してロードされるデータの最大サイズ（バイト単位）を指定する数値（> 0）。しきい値を超えると、 COPY 操作はファイルのロードを中止します。このオプションは、通常、複数の COPY ステートメントを使用してファイルの共通グループをロードするために使用されます。各ステートメントについて、次のステートメントに進む前に、指定された SIZE_LIMIT を超えるまでデータのロードが続行されます。

たとえば、ステージパス内の一連のファイルのサイズがそれぞれ10 MB であるとします。複数の COPY ステートメントが SIZE_LIMIT を 25000000 （25 MB）に設定すると、それぞれが3ファイルをロードします。つまり、 SIZE_LIMIT のしきい値を超えると、各 COPY 操作は中断されます。

ロードするファイルがない場合を除き、 SIZE_LIMIT に指定された値に関係なく、少なくとも1つのファイルがロードされることに注意してください。

デフォルト:

null（サイズ制限なし）

PURGE = TRUE | FALSE

使用:

データのロードのみ

定義:

データが正常にロードされた後、ステージからデータファイルを自動的に削除するかどうかを指定するブール値。

このオプションが TRUE に設定されている場合は、正常にロードされたデータファイルを削除するために最善の努力が払われることに注意してください。パージ操作が何らかの理由で失敗した場合、現在エラーは返されません。ステージングされたファイルを定期的にリストし（ LIST を使用）、正常にロードされたファイルがある場合は手動で削除することをお勧めします。

デフォルト:

FALSE

RETURN_FAILED_ONLY = TRUE | FALSE

使用:

データのロードのみ

定義:

ステートメント結果でロードに失敗したファイルのみを返すかどうかを指定するブール値。

デフォルト:

FALSE

MATCH_BY_COLUMN_NAME = CASE_SENSITIVE | CASE_INSENSITIVE | NONE

使用:

データのロードのみ

定義:

データで表される対応する列と一致するターゲットテーブルの列に半構造化データをロードするかどうかを指定する文字列。

このコピーオプションは、次のデータ形式でサポートされています。

• JSON

• Avro

• ORC

• Parquet

列が一致するには、次の条件を満たす必要があります。

• データで表される列は、テーブルの列と まったく同じ名前 である必要があります。コピーオプションは、列名の大文字と小文字を区別します。列の順序は関係ありません。

• テーブルの列には、データで表される列の値と互換性のあるデータ型が必要です。例えば、文字列、数値、ブール値はすべてバリアント列にロードできます。

値:

CASE_SENSITIVE | CASE_INSENSITIVE

データで表される対応する列に一致するターゲットテーブルの列に半構造化データをロードします。列名は、大文字と小文字が区別される（CASE_SENSITIVE）または大文字と小文字が区別されない（CASE_INSENSITIVE）です。

COPY 操作は、ターゲットテーブルの少なくとも1つの列がデータファイルで表される列と一致することを確認します。一致が見つかった場合、データファイルの値が1つまたは複数の列にロードされます。一致が見つからない場合、ファイル内の各記録の NULL 値のセットがテーブルにロードされます。

注釈

• 一致しない追加の列がデータファイルに存在する場合、これらの列の値はロードされません。

• 一致しない追加の列がターゲットテーブルに存在する場合、 COPY 操作はこれらの列に NULL 値を挿入します。これらの列は NULL 値をサポートする必要があります。

• COPY ステートメントでは、ロード中にデータをさらに変換するクエリを指定できません（つまり、 COPY 変換）。

NONE

COPY 操作は、半構造化データをバリアント列にロードするか、クエリが COPY ステートメントに含まれている場合にデータを変換します。

注釈

現在、次の制限が適用されます。

• ターゲットテーブルにロードするのではなく、ステージングされたデータを検証するために、 MATCH_BY_COLUMN_NAME を COPY ステートメントで VALIDATION_MODE パラメーターと共に使用することはできません。

• Parquetデータのみ。 MATCH_BY_COLUMN_NAME が CASE_SENSITIVE または CASE_INSENSITIVE に設定されている場合、空の列値（例： "col1": ""）はエラーを生成します。

デフォルト:

NONE

ENFORCE_LENGTH = TRUE | FALSE

使用:

データのロードのみ

定義:

リバースロジックを使用した TRUNCATECOLUMNS の代替構文（他のシステムとの互換性のため）

ターゲット列の長さを超えるテキスト文字列を切り捨てるかどうかを指定するブール値：

• TRUE の場合、ロードされた文字列がターゲット列の長さを超えると、 COPY ステートメントはエラーを生成します。

• FALSE の場合、文字列はターゲット列の長さに自動で切り捨てられます。

このコピーオプションは、 CSV データと、リレーショナルテーブルの個別の列にロードされた場合の半構造化データの文字列値をサポートします。

注釈

• ターゲット文字列の列の長さが最大に設定されている場合（例: VARCHAR (16777216)）、着信文字列はこの長さを超えることはできません。超えると、 COPY コマンドはエラーを生成します。

• このパラメーターは機能的には TRUNCATECOLUMNS と同等ですが、逆の動作をします。他のデータベースとの互換性のために提供されています。必要な出力を生成するには、 COPY ステートメントにこれら2つのパラメーターのいずれかを含めるだけです。

デフォルト:

TRUE

TRUNCATECOLUMNS = TRUE | FALSE

使用:

データのロードのみ

定義:

リバースロジックを使用した ENFORCE_LENGTH の代替構文（他のシステムとの互換性のため）

ターゲット列の長さを超えるテキスト文字列を切り捨てるかどうかを指定するブール値：

• TRUE の場合、文字列はターゲット列の長さに自動的に切り捨てられます。

• FALSE の場合、ロードされた文字列がターゲット列の長さを超えると、 COPY ステートメントはエラーを生成します。

このコピーオプションは、 CSV データと、リレーショナルテーブルの個別の列にロードされた場合の半構造化データの文字列値をサポートします。

注釈

• ターゲット文字列の列の長さが最大に設定されている場合（例: VARCHAR (16777216)）、着信文字列はこの長さを超えることはできません。超えると、 COPY コマンドはエラーを生成します。

• このパラメーターは機能的には ENFORCE_LENGTH と同等ですが、逆の動作をします。他のデータベースとの互換性のために提供されています。必要な出力を生成するには、 COPY ステートメントにこれら2つのパラメーターのいずれかを含めるだけです。

デフォルト:

FALSE

FORCE = TRUE | FALSE

使用:

データのロードのみ

定義:

以前にロードされたかどうか、ロード後に変更があったかどうかに関係なく、すべてのファイルをロードするよう指定するブール値。このオプションはファイルを再ロードし、テーブル内のデータを複製する可能性があることに注意します。

デフォルト:

FALSE

使用上の注意¶

• テーブルへの変更は、そのテーブルで作成されたビューに自動的に反映されません。たとえば、テーブル内の列をドロップし、その列を含むようにビューが定義されている場合、ビューは無効になります。ビューは列をドロップするように調整されていません。

• 列をドロップしても、列のストレージスペースはすぐに解放されません。

  • 各マイクロパーティションのスペースは、そのマイクロパーティションの再書き込みが行われるまで解放されません。そのマイクロパーティション内の1行以上に書き込み操作（挿入、更新、削除など）を行うと、マイクロパーティションが再書き込みされます。スペースを強制的に取り戻したい場合は、次の手順に従います。

    1. CREATE TABLE AS SELECT (CTAS) ステートメントを使用して、保持したい古いテーブルの列のみを含む新しいテーブルを作成します。

    2. 古いテーブルの DATA_RETENTION_TIME_IN_DAYS パラメーターを 0 に設定します（オプション）。

    3. テーブルをドロップします。

  • テーブルがTime Travel機能によって保護されている場合、Time Travelの保持期間が終了するまで、Time Travelストレージで使用されるスペースは解放されません。

• デフォルト値を持つ新しい列が既存の行を持つテーブルに追加されると、既存のすべての行にデフォルト値が入力されます。

• 関数を含むデフォルト値を持つ新しい列を追加することは、現在サポートされていません。次のエラーが返されます。

  Invalid column default expression (expr)

• テーブルを変更するには、テーブルの所有権限を持つロールを使用する必要があります。

• テーブルにクラスタリングを追加するには、テーブルを含むスキーマとデータベースに対する USAGE または OWNERSHIP 権限も必要です。

• マスキングポリシーの場合、

  • USING 句と FORCE キーワードはどちらもオプションです。どちらも、列にマスキングポリシーを設定する必要はありません。 USING 句と FORCE キーワードは、個別にまたは一緒に使用できます。詳細については、以下をご参照ください。

    • 列に条件付きマスキングポリシーを適用する

    • 列のマスキングポリシーを置き換える

  • テーブルの列構造がポリシーで指定された列と一致する場合は、条件付き列を使用する単一のマスキングポリシーを複数のテーブルに適用できます。

  • マスキングポリシーを使用して1つ以上のテーブル列を変更する場合、または行アクセスポリシーを使用してテーブル自体を変更する場合は、 POLICY_CONTEXT 関数を使用して、マスキングポリシーによって保護されている列と、行アクセスポリシーによって保護されているテーブルに対するクエリをシミュレートします。

• 行アクセスポリシーの場合、

  • Snowflakeは、単一の SQL ステートメントで行アクセスポリシーの追加とドロップをサポートしています。

    たとえば、テーブルにすでに設定されている行アクセスポリシーを別のポリシーに置き換えるには、最初に行アクセスポリシーをドロップしてから、新しい行アクセスポリシーを追加します。

  • 特定のリソース（つまり、テーブルまたはビュー）の場合、行アクセスポリシーを ADD または DROP するには、スキーマに対する APPLY ROW ACCESS POLICY 権限、 または リソースに対する OWNERSHIP 権限と行アクセスポリシーリソースに対する APPLY 権限が必要です。

  • テーブルまたはビューは、一度に1つの行アクセスポリシーでのみ保護できます。ポリシー本体が、行アクセスポリシーによって保護されているテーブルまたはビューの列、またはマスキングポリシーによって保護されている列を参照している場合、ポリシーの追加は失敗します。

    同様に、マスキングポリシー本体が、行アクセスポリシーまたは別のマスキングポリシーによって保護されているテーブルを参照している場合、テーブル列へのマスキングポリシーの追加は失敗します。

  • 行アクセスポリシーは、システムビューまたはテーブル関数には適用できません。

  • 他の DROP <オブジェクト> 操作と同様に、行アクセスポリシーが追加されていないリソースから行アクセスポリシーをドロップしようとすると、Snowflakeはエラーを返します。

  • オブジェクトに行アクセスポリシーと1つ以上のマスキングポリシーの両方がある場合は、行アクセスポリシーが最初に評価されます。

• 外部キーを作成する場合、 REFERENCES 句の列は、主キーの列と同じ順序でリストする必要があります。例:

  create table parent ... constraint primary_key_1 primary key (c_1, c_2) ...
  create table child  ... constraint foreign_key_1 foreign key (...) REFERENCES parent (c_1, c_2) ...
  

  Copy

  どちらの場合も、列の順序は c_1, c_2 です。外部キーの列の順序が異なっていた場合（例: c_2, c_1）、外部キーを作成する試みは失敗していました。

• メタデータについて、

  注意

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

• ALTER TABLE ... CHANGE_TRACKING = TRUE

  • 変更の追跡を有効にするためにテーブルが変更されると、テーブルは操作の間ロックされます。ロックにより、関連する DDL/DML オペレーションの一部で遅延が発生する可能性があります。詳細については、 リソースのロック をご参照ください。

• ハイブリッドテーブルでのインデックス:

  • ハイブリッドテーブルで ALTER TABLE コマンドを使用して一意制約または外部キー制約を追加またはドロップすると、対応するインデックスも作成または削除されます。ハイブリッドテーブルにおけるインデックスの詳細については、 CREATE INDEX をご参照ください。

  • 外部キー制約は、同じデータベースに格納されているハイブリッドテーブル間でのみサポートされています。ハイブリッドテーブルをあるデータベースから別のデータベースに移動する機能はサポートされていません。ハイブリッドテーブルに定義された主キー制約、一意制約、外部キー制約の RELY フィールドは TRUE とマークされます。

  • インデックスで使用されている列は、対応するインデックスがドロップされる前にドロップすることはできません。

例¶

次のセクションでは、 ALTER COLUMN コマンドの使用例を示します。

• テーブル名の変更

• テーブルの交換

• 列の追加

• 列の名前の変更

• 列の削除

• 外部テーブルの列の追加、名前の変更、ドロップ

• クラスタリングキーの順序の変更

• 行アクセスポリシーの追加とドロップ

CREATE OR REPLACE TABLE t1(a1 number);

SHOW TABLES LIKE 't1';

+-------------------------------+------+---------------+-------------+-------+---------+------------+------+-------+--------+----------------+-----------------+-------------+-------------------------+-----------------+----------+--------+
| created_on                    | name | database_name | schema_name | kind  | comment | cluster_by | rows | bytes | owner  | retention_time | change_tracking | is_external | enable_schema_evolution | owner_role_type | is_event | budget |
|-------------------------------+------+---------------+-------------+-------+---------+------------+------+-------+--------+----------------+-----------------+-------------+-------------------------+-----------------+----------+--------|
| 2023-10-19 10:37:04.858 -0700 | T1   | TESTDB        | MY_SCHEMA   | TABLE |         |            |    0 |     0 | PUBLIC | 1              | OFF             | N           | N                       | ROLE            | N        | NULL   |
+-------------------------------+------+---------------+-------------+-------+---------+------------+------+-------+--------+----------------+-----------------+-------------+-------------------------+-----------------+----------+--------+

ALTER TABLE t1 RENAME TO tt1;

SHOW TABLES LIKE 'tt1';

+-------------------------------+------+---------------+-------------+-------+---------+------------+------+-------+--------+----------------+-----------------+-------------+-------------------------+-----------------+----------+--------+
| created_on                    | name | database_name | schema_name | kind  | comment | cluster_by | rows | bytes | owner  | retention_time | change_tracking | is_external | enable_schema_evolution | owner_role_type | is_event | budget |
|-------------------------------+------+---------------+-------------+-------+---------+------------+------+-------+--------+----------------+-----------------+-------------+-------------------------+-----------------+----------+--------|
| 2023-10-19 10:37:04.858 -0700 | TT1  | TESTDB        | MY_SCHEMA   | TABLE |         |            |    0 |     0 | PUBLIC | 1              | OFF             | N           | N                       | ROLE            | N        | NULL   |
+-------------------------------+------+---------------+-------------+-------+---------+------------+------+-------+--------+----------------+-----------------+-------------+-------------------------+-----------------+----------+--------+

CREATE OR REPLACE TABLE t1(a1 NUMBER, a2 VARCHAR, a3 DATE);
CREATE OR REPLACE TABLE t2(b1 VARCHAR);

DESC TABLE t1;

+------+-------------------+--------+-------+---------+-------------+------------+-------+------------+---------+-------------+
| name | type              | kind   | null? | default | primary key | unique key | check | expression | comment | policy name |
|------+-------------------+--------+-------+---------+-------------+------------+-------+------------+---------+-------------|
| A1   | NUMBER(38,0)      | COLUMN | Y     | NULL    | N           | N          | NULL  | NULL       | NULL    | NULL        |
| A2   | VARCHAR(16777216) | COLUMN | Y     | NULL    | N           | N          | NULL  | NULL       | NULL    | NULL        |
| A3   | DATE              | COLUMN | Y     | NULL    | N           | N          | NULL  | NULL       | NULL    | NULL        |
+------+-------------------+--------+-------+---------+-------------+------------+-------+------------+---------+-------------+

DESC TABLE t2;

+------+-------------------+--------+-------+---------+-------------+------------+-------+------------+---------+-------------+
| name | type              | kind   | null? | default | primary key | unique key | check | expression | comment | policy name |
|------+-------------------+--------+-------+---------+-------------+------------+-------+------------+---------+-------------|
| B1   | VARCHAR(16777216) | COLUMN | Y     | NULL    | N           | N          | NULL  | NULL       | NULL    | NULL        |
+------+-------------------+--------+-------+---------+-------------+------------+-------+------------+---------+-------------+

ALTER TABLE t1 SWAP WITH t2;

DESC TABLE t1;

+------+-------------------+--------+-------+---------+-------------+------------+-------+------------+---------+-------------+
| name | type              | kind   | null? | default | primary key | unique key | check | expression | comment | policy name |
|------+-------------------+--------+-------+---------+-------------+------------+-------+------------+---------+-------------|
| B1   | VARCHAR(16777216) | COLUMN | Y     | NULL    | N           | N          | NULL  | NULL       | NULL    | NULL        |
+------+-------------------+--------+-------+---------+-------------+------------+-------+------------+---------+-------------+

DESC TABLE t2;

+------+-------------------+--------+-------+---------+-------------+------------+-------+------------+---------+-------------+
| name | type              | kind   | null? | default | primary key | unique key | check | expression | comment | policy name |
|------+-------------------+--------+-------+---------+-------------+------------+-------+------------+---------+-------------|
| A1   | NUMBER(38,0)      | COLUMN | Y     | NULL    | N           | N          | NULL  | NULL       | NULL    | NULL        |
| A2   | VARCHAR(16777216) | COLUMN | Y     | NULL    | N           | N          | NULL  | NULL       | NULL    | NULL        |
| A3   | DATE              | COLUMN | Y     | NULL    | N           | N          | NULL  | NULL       | NULL    | NULL        |
+------+-------------------+--------+-------+---------+-------------+------------+-------+------------+---------+-------------+

CREATE OR REPLACE TABLE t1(a1 NUMBER);

DESC TABLE t1;

+------+--------------+--------+-------+---------+-------------+------------+-------+------------+---------+-------------+
| name | type         | kind   | null? | default | primary key | unique key | check | expression | comment | policy name |
|------+--------------+--------+-------+---------+-------------+------------+-------+------------+---------+-------------|
| A1   | NUMBER(38,0) | COLUMN | Y     | NULL    | N           | N          | NULL  | NULL       | NULL    | NULL        |
+------+--------------+--------+-------+---------+-------------+------------+-------+------------+---------+-------------+

ALTER TABLE t1 ADD COLUMN a2 NUMBER;

ALTER TABLE t1 ADD COLUMN a3 NUMBER NOT NULL;

ALTER TABLE t1 ADD COLUMN a4 NUMBER DEFAULT 0 NOT NULL;

ALTER TABLE t1 ADD COLUMN a5 VARCHAR COLLATE 'en_US';

DESC TABLE t1;

+------+-----------------------------------+--------+-------+---------+-------------+------------+-------+------------+---------+-------------+
| name | type                              | kind   | null? | default | primary key | unique key | check | expression | comment | policy name |
|------+-----------------------------------+--------+-------+---------+-------------+------------+-------+------------+---------+-------------|
| A1   | NUMBER(38,0)                      | COLUMN | Y     | NULL    | N           | N          | NULL  | NULL       | NULL    | NULL        |
| A2   | NUMBER(38,0)                      | COLUMN | Y     | NULL    | N           | N          | NULL  | NULL       | NULL    | NULL        |
| A3   | NUMBER(38,0)                      | COLUMN | N     | NULL    | N           | N          | NULL  | NULL       | NULL    | NULL        |
| A4   | NUMBER(38,0)                      | COLUMN | N     | 0       | N           | N          | NULL  | NULL       | NULL    | NULL        |
| A5   | VARCHAR(16777216) COLLATE 'en_us' | COLUMN | Y     | NULL    | N           | N          | NULL  | NULL       | NULL    | NULL        |
+------+-----------------------------------+--------+-------+---------+-------------+------------+-------+------------+---------+-------------+

ALTER TABLE t1 ADD COLUMN IF NOT EXISTS a2 NUMBER;

DESC TABLE t1;

+------+-----------------------------------+--------+-------+---------+-------------+------------+-------+------------+---------+-------------+
| name | type                              | kind   | null? | default | primary key | unique key | check | expression | comment | policy name |
|------+-----------------------------------+--------+-------+---------+-------------+------------+-------+------------+---------+-------------|
| A1   | NUMBER(38,0)                      | COLUMN | Y     | NULL    | N           | N          | NULL  | NULL       | NULL    | NULL        |
| A2   | NUMBER(38,0)                      | COLUMN | Y     | NULL    | N           | N          | NULL  | NULL       | NULL    | NULL        |
| A3   | NUMBER(38,0)                      | COLUMN | N     | NULL    | N           | N          | NULL  | NULL       | NULL    | NULL        |
| A4   | NUMBER(38,0)                      | COLUMN | N     | 0       | N           | N          | NULL  | NULL       | NULL    | NULL        |
| A5   | VARCHAR(16777216) COLLATE 'en_us' | COLUMN | Y     | NULL    | N           | N          | NULL  | NULL       | NULL    | NULL        |
+------+-----------------------------------+--------+-------+---------+-------------+------------+-------+------------+---------+-------------+

ALTER TABLE t1 RENAME COLUMN a1 TO b1;

DESC TABLE t1;

+------+--------------+--------+-------+---------+-------------+------------+-------+------------+---------+-------------+
| name | type         | kind   | null? | default | primary key | unique key | check | expression | comment | policy name |
|------+--------------+--------+-------+---------+-------------+------------+-------+------------+---------+-------------|
| B1   | NUMBER(38,0) | COLUMN | Y     | NULL    | N           | N          | NULL  | NULL       | NULL    | NULL        |
| A2   | NUMBER(38,0) | COLUMN | Y     | NULL    | N           | N          | NULL  | NULL       | NULL    | NULL        |
| A3   | NUMBER(38,0) | COLUMN | N     | NULL    | N           | N          | NULL  | NULL       | NULL    | NULL        |
| A4   | NUMBER(38,0) | COLUMN | N     | 0       | N           | N          | NULL  | NULL       | NULL    | NULL        |
+------+--------------+--------+-------+---------+-------------+------------+-------+------------+---------+-------------+

ALTER TABLE t1 DROP COLUMN a2;

DESC TABLE t1;

+------+--------------+--------+-------+---------+-------------+------------+-------+------------+---------+-------------+
| name | type         | kind   | null? | default | primary key | unique key | check | expression | comment | policy name |
|------+--------------+--------+-------+---------+-------------+------------+-------+------------+---------+-------------|
| B1   | NUMBER(38,0) | COLUMN | Y     | NULL    | N           | N          | NULL  | NULL       | NULL    | NULL        |
| A3   | NUMBER(38,0) | COLUMN | N     | NULL    | N           | N          | NULL  | NULL       | NULL    | NULL        |
| A4   | NUMBER(38,0) | COLUMN | N     | 0       | N           | N          | NULL  | NULL       | NULL    | NULL        |
+------+--------------+--------+-------+---------+-------------+------------+-------+------------+---------+-------------+

ALTER TABLE t1 DROP COLUMN IF EXISTS a2;

+------+--------------+--------+-------+---------+-------------+------------+-------+------------+---------+-------------+
| name | type         | kind   | null? | default | primary key | unique key | check | expression | comment | policy name |
|------+--------------+--------+-------+---------+-------------+------------+-------+------------+---------+-------------|
| B1   | NUMBER(38,0) | COLUMN | Y     | NULL    | N           | N          | NULL  | NULL       | NULL    | NULL        |
| A3   | NUMBER(38,0) | COLUMN | N     | NULL    | N           | N          | NULL  | NULL       | NULL    | NULL        |
| A4   | NUMBER(38,0) | COLUMN | N     | 0       | N           | N          | NULL  | NULL       | NULL    | NULL        |
+------+--------------+--------+-------+---------+-------------+------------+-------+------------+---------+-------------+

CREATE EXTERNAL TABLE exttable1
  LOCATION=@mystage/logs/
  AUTO_REFRESH = true
  FILE_FORMAT = (TYPE = PARQUET)
  ;

DESC EXTERNAL TABLE exttable1;

+-----------+-------------------+-----------+-------+---------+-------------+------------+-------+----------------------------------------------------------+-----------------------+
| name      | type              | kind      | null? | default | primary key | unique key | check | expression                                               | comment               |
|-----------+-------------------+-----------+-------+---------+-------------+------------+-------+----------------------------------------------------------+-----------------------|
| VALUE     | VARIANT           | COLUMN    | Y     | NULL    | N           | N          | NULL  | NULL                                                     | The value of this row |
+-----------+-------------------+-----------+-------+---------+-------------+------------+-------+----------------------------------------------------------+-----------------------+

ALTER TABLE exttable1 ADD COLUMN a1 VARCHAR AS (value:a1::VARCHAR);

DESC EXTERNAL TABLE exttable1;

+-----------+-------------------+-----------+-------+---------+-------------+------------+-------+----------------------------------------------------------+-----------------------+
| name      | type              | kind      | null? | default | primary key | unique key | check | expression                                               | comment               |
|-----------+-------------------+-----------+-------+---------+-------------+------------+-------+----------------------------------------------------------+-----------------------|
| VALUE     | VARIANT           | COLUMN    | Y     | NULL    | N           | N          | NULL  | NULL                                                     | The value of this row |
| A1        | VARCHAR(16777216) | VIRTUAL   | Y     | NULL    | N           | N          | NULL  | TO_CHAR(GET(VALUE, 'a1'))                                | NULL                  |
+-----------+-------------------+-----------+-------+---------+-------------+------------+-------+----------------------------------------------------------+-----------------------+

ALTER TABLE exttable1 RENAME COLUMN a1 TO b1;

DESC EXTERNAL TABLE exttable1;

+-----------+-------------------+-----------+-------+---------+-------------+------------+-------+----------------------------------------------------------+-----------------------+
| name      | type              | kind      | null? | default | primary key | unique key | check | expression                                               | comment               |
|-----------+-------------------+-----------+-------+---------+-------------+------------+-------+----------------------------------------------------------+-----------------------|
| VALUE     | VARIANT           | COLUMN    | Y     | NULL    | N           | N          | NULL  | NULL                                                     | The value of this row |
| B1        | VARCHAR(16777216) | VIRTUAL   | Y     | NULL    | N           | N          | NULL  | TO_CHAR(GET(VALUE, 'a1'))                                | NULL                  |
+-----------+-------------------+-----------+-------+---------+-------------+------------+-------+----------------------------------------------------------+-----------------------+

ALTER TABLE exttable1 DROP COLUMN b1;

DESC EXTERNAL TABLE exttable1;

+-----------+-------------------+-----------+-------+---------+-------------+------------+-------+----------------------------------------------------------+-----------------------+
| name      | type              | kind      | null? | default | primary key | unique key | check | expression                                               | comment               |
|-----------+-------------------+-----------+-------+---------+-------------+------------+-------+----------------------------------------------------------+-----------------------|
| VALUE     | VARIANT           | COLUMN    | Y     | NULL    | N           | N          | NULL  | NULL                                                     | The value of this row |
+-----------+-------------------+-----------+-------+---------+-------------+------------+-------+----------------------------------------------------------+-----------------------+

CREATE OR REPLACE TABLE T1 (id NUMBER, date TIMESTAMP_NTZ, name STRING) CLUSTER BY (id, date);

SHOW TABLES LIKE 'T1';

---------------------------------+------+---------------+-------------+-------+---------+------------+------+-------+--------------+----------------+
           created_on            | name | database_name | schema_name | kind  | comment | cluster_by | rows | bytes |    owner     | retention_time |
---------------------------------+------+---------------+-------------+-------+---------+------------+------+-------+--------------+----------------+
 Tue, 21 Jun 2016 15:42:12 -0700 | T1   | TESTDB        | TESTSCHEMA  | TABLE |         | (ID,DATE)  | 0    | 0     | ACCOUNTADMIN | 1              |
---------------------------------+------+---------------+-------------+-------+---------+------------+------+-------+--------------+----------------+

ALTER TABLE t1 CLUSTER BY (date, id);

SHOW TABLES LIKE 'T1';

---------------------------------+------+---------------+-------------+-------+---------+------------+------+-------+--------------+----------------+
           created_on            | name | database_name | schema_name | kind  | comment | cluster_by | rows | bytes |    owner     | retention_time |
---------------------------------+------+---------------+-------------+-------+---------+------------+------+-------+--------------+----------------+
 Tue, 21 Jun 2016 15:42:12 -0700 | T1   | TESTDB        | TESTSCHEMA  | TABLE |         | (DATE,ID)  | 0    | 0     | ACCOUNTADMIN | 1              |
---------------------------------+------+---------------+-------------+-------+---------+------------+------+-------+--------------+----------------+