CREATE TABLE¶

CREATE OR ALTER TABLE¶

テーブルが存在しない場合は作成するか、テーブル定義に従ってテーブルを変更します。CREATE OR ALTER TABLE 構文は CREATE TABLE ステートメントのルールに従い、この構文には ALTER TABLE ステートメントと同じ制限があります。テーブルが変換されても、テーブル内の既存のデータは可能な限り保持されます。列をドロップする必要がある場合は、データ損失が発生する可能性があります。

テーブルを変更する場合は、以下の変更がサポートされます。

• テーブルのプロパティとパラメーターを変更します。例: ENABLE_SCHEMA_EVOLUTION、 DATA_RETENTION_TIME_IN_DAYS、または CLUSTER BY。

• 列のデータ型、デフォルト値、NULL値の許容、コメント、または自動増分を変更します。

• 列リストの最後に新しい列を追加します。

• 列をドロップします。

• インラインまたはアウトオブライン制約を追加、ドロップ、変更します。

• クラスタリングキーを追加、ドロップ、変更します。

詳細については、 CREATE OR ALTER TABLE の使用上の注意 をご参照ください。

CREATE OR ALTER
    [ { [ { LOCAL | GLOBAL } ] TEMP | TEMPORARY | TRANSIENT } ]
  TABLE <table_name> (
    -- Column definition
    <col_name> <col_type>
      [ inlineConstraint ]
      [ NOT NULL ]
      [ COLLATE '<collation_specification>' ]
      [
        {
          DEFAULT <expr>
          | { AUTOINCREMENT | IDENTITY }
            [
              {
                ( <start_num> , <step_num> )
                | START <num> INCREMENT <num>
              }
            ]
            [ { ORDER | NOORDER } ]
        }
      ]
      [ COMMENT '<string_literal>' ]

    -- Additional column definitions
    [ , <col_name> <col_type> [ ... ] ]

    -- Out-of-line constraints
    [ , outoflineConstraint [ ... ] ]
  )
  [ CLUSTER BY ( <expr> [ , <expr> , ... ] ) ]
  [ ENABLE_SCHEMA_EVOLUTION = { TRUE | FALSE } ]
  [ DATA_RETENTION_TIME_IN_DAYS = <integer> ]
  [ MAX_DATA_EXTENSION_TIME_IN_DAYS = <integer> ]
  [ CHANGE_TRACKING = { TRUE | FALSE } ]
  [ DEFAULT_DDL_COLLATION = '<collation_specification>' ]
  [ COMMENT = '<string_literal>' ]

CREATE TABLE ... AS SELECT （CTAS とも呼ばれる）¶

クエリによって返されたデータが入力される新しいテーブルを作成します。

CREATE [ OR REPLACE ] TABLE <table_name> [ ( <col_name> [ <col_type> ] , <col_name> [ <col_type> ] , ... ) ]
  [ CLUSTER BY ( <expr> [ , <expr> , ... ] ) ]
  [ COPY GRANTS ]
  AS <query>
  [ ... ]

Copy

マスキングポリシーは、 CTAS ステートメントの列に適用できます。列のデータ型の後にマスキングポリシーを指定します。同様に、行アクセスポリシーをテーブルに適用できます。例:

CREATE TABLE <table_name> ( <col1> <data_type> [ WITH ] MASKING POLICY <policy_name> [ , ... ] )
  ...
  [ WITH ] ROW ACCESS POLICY <policy_name> ON ( <col1> [ , ... ] )
  AS <query>
  [ ... ]

Copy

CREATE TABLE ... USING TEMPLATE¶

INFER_SCHEMA 関数を使用してステージングされたファイルのセットから派生した列定義で、新しいテーブルを作成します。この機能は、Apache Parquet、Apache Avro、 ORC、 JSON、 CSV ファイルをサポートしています。

CREATE [ OR REPLACE ] TABLE <table_name>
  [ COPY GRANTS ]
  USING TEMPLATE <query>
  [ ... ]

Copy

COPY GRANTS の詳細については、このドキュメント内の COPY GRANTS をご参照ください。

CREATE TABLE ... LIKE¶

既存のテーブルと同じ列定義を使用して新しいテーブルを作成しますが、既存のテーブルからデータをコピーしません。列名、タイプ、デフォルト、および制約が新しいテーブルにコピーされます。

CREATE [ OR REPLACE ] TABLE <table_name> LIKE <source_table>
  [ CLUSTER BY ( <expr> [ , <expr> , ... ] ) ]
  [ COPY GRANTS ]
  [ ... ]

Copy

COPY GRANTS の詳細については、このドキュメント内の COPY GRANTS をご参照ください。

注釈

データ共有を介してアクセスされる自動インクリメントシーケンスを持つテーブルに対するCREATE TABLE ... LIKEは、現在 サポートされていません。

CREATE TABLE ... CLONE¶

データを実際にコピーすることなく、同じ列定義を使用して、ソーステーブルのすべての既存データを含む新しいテーブルを作成します。このバリアントは、過去の特定の時間/ポイントでテーブルをクローンするためにも使用できます（ Time Travel を使用）。

CREATE [ OR REPLACE ]
    [ {
          [ { LOCAL | GLOBAL } ] TEMP [ READ ONLY ] |
          TEMPORARY [ READ ONLY ] |
          VOLATILE |
          TRANSIENT
    } ]
  TABLE <name> CLONE <source_table>
    [ { AT | BEFORE } ( { TIMESTAMP => <timestamp> | OFFSET => <time_difference> | STATEMENT => <id> } ) ]
    [ COPY GRANTS ]
    [ ... ]

Copy

COPY GRANTS の詳細については、このドキュメント内の COPY GRANTS をご参照ください。

クローンの詳細については、 CREATE <オブジェクト> ... CLONE をご参照ください。

基本的な例¶

現在のデータベースに単純なテーブルを作成し、テーブルに行を挿入します。

CREATE TABLE mytable (amount NUMBER);

+-------------------------------------+
| status                              |
|-------------------------------------|
| Table MYTABLE successfully created. |
+-------------------------------------+

INSERT INTO mytable VALUES(1);

SHOW TABLES like 'mytable';

+---------------------------------+---------+---------------+-------------+-------+---------+------------+------+-------+--------------+----------------+
| created_on                      | name    | database_name | schema_name | kind  | comment | cluster_by | rows | bytes | owner        | retention_time |
|---------------------------------+---------+---------------+-------------+-------+---------+------------+------+-------+--------------+----------------|
| Mon, 11 Sep 2017 16:32:28 -0700 | MYTABLE | TESTDB        | PUBLIC      | TABLE |         |            |    1 |  1024 | ACCOUNTADMIN | 1              |
+---------------------------------+---------+---------------+-------------+-------+---------+------------+------+-------+--------------+----------------+

DESC TABLE mytable;

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

Copy

単純なテーブルを作成し、テーブルとテーブル内の列の両方にコメントを指定します。

CREATE TABLE example (col1 NUMBER COMMENT 'a column comment') COMMENT='a table comment';

+-------------------------------------+
| status                              |
|-------------------------------------|
| Table EXAMPLE successfully created. |
+-------------------------------------+

SHOW TABLES LIKE 'example';

+---------------------------------+---------+---------------+-------------+-------+-----------------+------------+------+-------+--------------+----------------+
| created_on                      | name    | database_name | schema_name | kind  | comment         | cluster_by | rows | bytes | owner        | retention_time |
|---------------------------------+---------+---------------+-------------+-------+-----------------+------------+------+-------+--------------+----------------|
| Mon, 11 Sep 2017 16:35:59 -0700 | EXAMPLE | TESTDB        | PUBLIC      | TABLE | a table comment |            |    0 |     0 | ACCOUNTADMIN | 1              |
+---------------------------------+---------+---------------+-------------+-------+-----------------+------------+------+-------+--------------+----------------+

DESC TABLE example;

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

Copy

CTAS 例¶

既存のテーブルから選択してテーブルを作成します。

CREATE TABLE mytable_copy (b) AS SELECT * FROM mytable;

DESC TABLE mytable_copy;

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

CREATE TABLE mytable_copy2 AS SELECT b+1 AS c FROM mytable_copy;

DESC TABLE mytable_copy2;

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

SELECT * FROM mytable_copy2;

+---+
| C |
|---|
| 2 |
+---+

Copy

既存のテーブルから選択してテーブルを作成するより高度な例。この例では、新しいテーブルの summary_amount 列の値は、ソーステーブルの2つの列から派生しています。

CREATE TABLE testtable_summary (name, summary_amount) AS SELECT name, amount1 + amount2 FROM testtable;

Copy

段階的なParquetデータファイルから列を選択して、テーブルを作成します。

CREATE OR REPLACE TABLE parquet_col (
  custKey NUMBER DEFAULT NULL,
  orderDate DATE DEFAULT NULL,
  orderStatus VARCHAR(100) DEFAULT NULL,
  price VARCHAR(255)
)
AS SELECT
  $1:o_custkey::number,
  $1:o_orderdate::date,
  $1:o_orderstatus::text,
  $1:o_totalprice::text
FROM @my_stage;

+-----------------------------------------+
| status                                  |
|-----------------------------------------|
| Table PARQUET_COL successfully created. |
+-----------------------------------------+

DESC TABLE parquet_col;

+-------------+--------------+--------+-------+---------+-------------+------------+-------+------------+---------+
| name        | type         | kind   | null? | default | primary key | unique key | check | expression | comment |
|-------------+--------------+--------+-------+---------+-------------+------------+-------+------------+---------|
| CUSTKEY     | NUMBER(38,0) | COLUMN | Y     | NULL    | N           | N          | NULL  | NULL       | NULL    |
| ORDERDATE   | DATE         | COLUMN | Y     | NULL    | N           | N          | NULL  | NULL       | NULL    |
| ORDERSTATUS | VARCHAR(100) | COLUMN | Y     | NULL    | N           | N          | NULL  | NULL       | NULL    |
| PRICE       | VARCHAR(255) | COLUMN | Y     | NULL    | N           | N          | NULL  | NULL       | NULL    |
+-------------+--------------+--------+-------+---------+-------------+------------+-------+------------+---------+

Copy

CREATE TABLE ... LIKE の例¶

別のテーブルと同じ列定義を持つが、行がないテーブルを作成します。

CREATE TABLE mytable (amount NUMBER);

INSERT INTO mytable VALUES(1);

SELECT * FROM mytable;

+--------+
| AMOUNT |
|--------|
|      1 |
+--------+

CREATE TABLE mytable_2 LIKE mytable;

DESC TABLE mytable_2;

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

SELECT * FROM mytable_2;

+--------+
| AMOUNT |
|--------|
+--------+

Copy

パラメーターとプロパティを設定する CREATE TABLE の例¶

複数列のクラスタリングキーを持つテーブルを作成します。

CREATE TABLE mytable (date TIMESTAMP_NTZ, id NUMBER, content VARIANT) CLUSTER BY (date, id);

SHOW TABLES LIKE 'mytable';

+---------------------------------+---------+---------------+-------------+-------+---------+------------------+------+-------+--------------+----------------+
| created_on                      | name    | database_name | schema_name | kind  | comment | cluster_by       | rows | bytes | owner        | retention_time |
|---------------------------------+---------+---------------+-------------+-------+---------+------------------+------+-------+--------------+----------------|
| Mon, 11 Sep 2017 16:20:41 -0700 | MYTABLE | TESTDB        | PUBLIC      | TABLE |         | LINEAR(DATE, ID) |    0 |     0 | ACCOUNTADMIN | 1              |
+---------------------------------+---------+---------------+-------------+-------+---------+------------------+------+-------+--------------+----------------+

Copy

テーブルの列の照合を指定します。

CREATE OR REPLACE TABLE collation_demo (
  uncollated_phrase VARCHAR, 
  utf8_phrase VARCHAR COLLATE 'utf8',
  english_phrase VARCHAR COLLATE 'en',
  spanish_phrase VARCHAR COLLATE 'es');

INSERT INTO collation_demo (
      uncollated_phrase, 
      utf8_phrase, 
      english_phrase, 
      spanish_phrase) 
   VALUES (
     'pinata', 
     'pinata', 
     'pinata', 
     'piñata');

Copy

CREATE TABLE ... USING TEMPLATE の例¶

Avro、Parquet、または ORC データを含むステージングされたファイルのセットから列定義が派生するテーブルを作成します。

ステートメントで参照されている mystage ステージと my_parquet_format ファイル形式がすでに存在している必要があることに注意してください。ファイルのセットは、ステージ定義で参照されるクラウドストレージの場所に既にステージングされている必要があります。

次の例では、ステージングされたファイルから検出されたスキーマを使用してテーブルを作成し、列を order_id で並べ替えます。これは、 INFER_SCHEMA トピックの例に基づいて構築されています。

CREATE TABLE mytable
  USING TEMPLATE (
    SELECT ARRAY_AGG(OBJECT_CONSTRUCT(*))
    WITHIN GROUP (ORDER BY order_id)
      FROM TABLE(
        INFER_SCHEMA(
          LOCATION=>'@mystage',
          FILE_FORMAT=>'my_parquet_format'
        )
      ));

Copy

order_id による列の並べ替えは、ステージングされたファイルすべてが1つのスキーマを共有する場合にのみ適用されることに注意してください。ステージングされたデータファイルのセットに、列名が共有されている複数のスキーマが含まれている場合は、 order_id 列で表される順序が単一のファイルと一致しない可能性があります。

仮テーブルの例¶

セッションの終了時に自動的にドロップされる仮テーブルを作成します。

CREATE TEMPORARY TABLE demo_temporary (i INTEGER);
CREATE TEMP TABLE demo_temp (i INTEGER);

Copy

他のベンダーとの互換性のために、Snowflakeは以下のキーワードを TEMPORARY の同義語として使用することもサポートしています。

CREATE LOCAL TEMPORARY TABLE demo_local_temporary (i INTEGER);
CREATE LOCAL TEMP TABLE demo_local_temp (i INTEGER);

CREATE GLOBAL TEMPORARY TABLE demo_global_temporary (i INTEGER);
CREATE GLOBAL TEMP TABLE demo_global_temp (i INTEGER);

CREATE VOLATILE TABLE demo_volatile (i INTEGER);

Copy

CREATE OR ALTER TABLE の例¶

CREATE OR ALTER TABLE コマンドを使用してテーブル my_table を作成します。

CREATE OR ALTER TABLE my_table(a INT);

テーブル my_table を変更し、列を追加して修正し、 DATA_RETENTION_TIME_IN_DAYS と DEFAULT_DDL_COLLATION パラメーターを設定します。

CREATE OR ALTER TABLE my_table(
    a INT PRIMARY KEY,
    b VARCHAR(200)
  )
  DATA_RETENTION_TIME_IN_DAYS = 5
  DEFAULT_DDL_COLLATION = 'de';

DATA_RETENTION_TIME_IN_DAYS パラメーターの設定を解除します。変更されたテーブル定義にパラメーターがない場合は、パラメーターの設定が解除されます。この場合、テーブルの DATA_RETENTION_TIME_IN_DAYS パラメーターの設定を解除すると、デフォルト値の 1 にリセットされます。

CREATE OR ALTER TABLE my_table(
    a INT PRIMARY KEY,
    c VARCHAR(200)
  )
  DEFAULT_DDL_COLLATION = 'de';

CREATE OR ALTER TABLE コマンドにより、列リストの最後に列を追加することができます。既存の列の名前を変更しようとすると、既存の列はドロップされ、新しい列名の新しい列が追加されます。元の列にデータが存在する場合は、データが失われる可能性があります。

次の例はこの動作を示しています。

1. テーブルを作成します。

   CREATE OR ALTER TABLE my_table(
       a INT PRIMARY KEY,
       b INT
     );
   

   Copy

2. テーブル my_table にデータを挿入します。

   INSERT INTO my_table VALUES (1, 2), (2, 3);
   
   SELECT * FROM my_table;
   

   Copy

   戻り値:

   +---+---+
   | A | B |
   |---+---|
   | 1 | 2 |
   | 2 | 3 |
   +---+---+
   

3. 列 b の名前の変更を試みます。

   CREATE OR ALTER TABLE my_table(
       a INT PRIMARY KEY,
       c INT
     );
   

   Copy

   列 b がドロップされ、列 c が追加されます。

   SELECT * FROM my_table;
   

   Copy

   戻り値:

   +---+------+
   | A | C    |
   |---+------|
   | 1 | NULL |
   | 2 | NULL |
   +---+------+
   

   注釈

   Time Travel を使用して、ドロップされた列を復元できます。

インライン主キーを設定または設定解除すると、CREATE TABLE コマンドの動作と整合性が取れるように列のNULL値の許容が変更されますが、 ALTER TABLE コマンドの動作とは異なります。たとえば、 ALTER TABLE ステートメントを使用して列に主キー制約を追加しても、列のNULL値の許容は変わりません。

次の例はこの動作を示しています。

1. テーブルを作成します。

   CREATE TABLE t(a INT);
   

   Copy

2. テーブルを変更して、PRIMARY KEY 制約を追加します。

   CREATE OR ALTER TABLE t(a INT PRIMARY KEY);
   

   Copy

   列 a が主キーになり、 NOT NULL に設定されます。

   DESC TABLE t;
   

   Copy

   戻り値:

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

3. テーブル t を置き換えます。

   CREATE OR REPLACE TABLE t(a INT);
   

   Copy

4. NULL 値を挿入します。

   INSERT INTO t VALUES (null);
   

   Copy

5. 列 a に主キー制約を追加します。

   列 a の NULL 値により、以下のステートメントが失敗します。

   CREATE OR ALTER TABLE t(a INT PRIMARY KEY);
   

   Copy

   戻り値:

   001471 (42601): SQL compilation error:
   Column 'A' contains null values. Not null constraint cannot be added.