■ はじめに

Snowflake の Table定義 (具体的には default値を変更) を変更する
必要ができたので、予習をしておく。

Table定義変更に関して調べた結果...

* SnowflakeのALTER TABLEでは、default値を変更は対象外だった、、、
* Table定義変更を OR REPLACE 使ってお茶を濁そうかなっと思ったが、
　ダメだった。。。

【０】テーブルの種類
　１）仮テーブル - TEMPORARY
　２）一時テーブル - TRANSIENT
　３）永続テーブル
【１】CREATE TABLE
　１）CREATE OR REPLACE TABLE
【２】ALTER TABLE
　１）ALTER TABLE ... ALTER COLUMN
　２）ALTER TABLE ... DROP COLUMN
　３）ALTER TABLE ... RENAME TO
　４）使用上の注意
【３】補足１：テーブル定義確認
【４】補足２：外部テーブル

【０】テーブルの種類

https://docs.snowflake.com/ja/user-guide/tables-temp-transient#comparison-of-table-types

#	Table	Keyword	持続性
1	仮テーブル	TEMP / TEMPORARY	セッション終了まで
2	一時テーブル	TRANSIENT	明示的に削除されるまで
3	永続テーブル	- (テーブルが TEMPORARY または TRANSIENT として宣言されていない場合、そのテーブルは永続的)	明示的に削除されるまで

１）仮テーブル - TEMPORARY

* 非永続的な一時データを保存するための一時テーブル
* 作成されたセッション内のみに持続するテーブル
 => セッションが終了すると、テーブルに保存されたデータは
　　システムから完全に消去される
 => 処理中の一時テーブルとして使用

https://docs.snowflake.com/ja/user-guide/tables-temp-transient#temporary-tables

補足

* 他ユーザーまたはセッションには表示されない
* テーブルを作成したユーザーまたはSnowflakeのいずれによっても回復できない

２）一時テーブル - TRANSIENT

* 明示的に削除するまで持続する (一時テーブルとの違い)
* タイムトラベルは最大1日まで
* Snowflake Fail-safeが利用できないこと (永続テーブルとの違い)

cf. transient (トランジェント) = 一時的な，つかのまの，はかない

https://docs.snowflake.com/ja/user-guide/tables-temp-transient#transient-tables

* なお、Snowflake Fail-safeやSnowflake Time Travelについては、
　以下の関連記事を参照のこと

Snowflake ～ Time Travel / Fail-safe ～
https://dk521123.hatenablog.com/entry/2025/08/31/005438

メリット

* Snowflake Fail-safeコストが削減できる
　（Fail-safeディザスタリカバリに必要なデータの維持に関連するコスト）

デメリット

* Snowflake Time Travelの保持期間が経過すると回復できない
 => 障害から保護する必要がないデータ
　 or Snowflakeの外部で再構築できるデータには、
　一時テーブル のみ を使用することが推奨

３）永続テーブル

* 普通のテーブル

cf. 永続 (Permanent)

【１】CREATE TABLE

* CREATE文に関しては、
　普通に使う分には通常のSQL文とあまり変わらない
 => 不安な部分や足りない部分は、以下の公式で補えばいい

https://docs.snowflake.com/ja/sql-reference/sql/create-table.html

* 今回取り上げていないが、他にも
　「CREATE TABLE ... AS SELECT」「CREATE TABLE ... USING TEMPLATE」
　などがあるみたいだが、必要になったら書き足していく、、、

例

-- 例：if not exists
create table sample_table if not exists (
  id number default null,
  name varchar(100) default null,
  birth_date date default null,
  remarks varchar(255)
);

-- transientテーブル（一時テーブル）の場合
-- create transient table sample_table if not exists (...

１）CREATE OR REPLACE TABLE

* 「create or replace table sample_table (...」のように
　「or replace」を指定して、置き換えることができる
 => ただし、動き的には、DROPしてしまうので、
　　一時テーブルなどで使用する位に留めておいた方がいい
　　（詳細は、以下「使用上の注意」を参照）

２）使用上の注意

https://docs.snowflake.com/ja/sql-reference/sql/create-table.html#usage-notes

より抜粋
~~~~~~~
! 重要
-----
OR REPLACE を使用することは、
既存のテーブルで DROP TABLE を使用してから、
同じ名前で新しいテーブルを作成することと同等です。
~~~~~~~
 => DROPしてしまうので、データが入っていたら消えてしまう

【２】ALTER TABLE

* 既存のテーブルのプロパティ、列、または制約を変更
* ALTER TABLE文は、ちょっことSQL文の違う印象、、、

https://docs.snowflake.com/ja/sql-reference/sql/alter-table.html

１）ALTER TABLE ... ALTER COLUMN

https://docs.snowflake.com/ja/sql-reference/sql/alter-table-column.html

２）ALTER TABLE ... DROP COLUMN

* 項目削除

https://docs.snowflake.com/ja/sql-reference/sql/alter-table

サンプル
https://ninthcode.net/240620-snowflake-drop-column/

-- DROP COLUMN [ IF EXISTS ] col_name [ CASCADE | RESTRICT ]
-- 指定した列をテーブルから削除します。

ALTER TABLE your_table_name DROP COLUMN Col1;
ALTER TABLE your_table_name DROP COLUMN Col2;

３）ALTER TABLE ... RENAME TO

* テーブルのリネーム

https://docs.snowflake.com/ja/sql-reference/sql/alter-table.html
構文

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

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

４）使用上の注意

[1] サポート対象外が結構ある
https://docs.snowflake.com/ja/sql-reference/sql/alter-table-column.html

より、「サポート対象外」のみ抜粋

# やりたかった「default値の変更」ができない、、、
# その他にも #2, #3, #5ができないのは痛いかも、、、

#	カテゴリ	サポート対象外のアクション	例
1	デフォルト値	デフォルトがシーケンスでない限り、列のデフォルトを変更できない	DATE型のデフォルトにCURRENT_DATE()が設定してあったのをsysdate()::dateに変更できない
2	デフォルト値	列のデフォルトを追加できない	何も設定していないNUMBER型にデフォルト「-1」を追加できない
3	データ型	列のデータ型を同義の型に変更できない	STRING から NUMBER に変更できない
4	データ型	テキスト/文字列の列の長さを短くできない	VARCHAR(50) から VARCHAR(25) に変更できない
5	データ型	数値列のスケールを変更できない	NUMBER(10,2) から NUMBER(10,4) に変更できない

【３】補足１：テーブル定義確認

https://dk521123.hatenablog.com/entry/2022/02/24/231532

で紹介した DESC を使えばいい（GUIでも見れるけど）

例

-- DESC TABLE <your-table>;
DESC TABLE sample_table;

【４】補足２：外部テーブル

* Snowflake にも外部テーブルはある。

外部テーブルの概要
https://docs.snowflake.com/ja/user-guide/tables-external-intro.html
CREATE EXTERNAL TABLE
https://docs.snowflake.com/ja/sql-reference/sql/create-external-table.html

ランキング参加中

プログラミング

【Snowflake】Snowflake ～基本編 / テーブル～

■ はじめに

目次

【０】テーブルの種類

１）仮テーブル - TEMPORARY

２）一時テーブル - TRANSIENT

３）永続テーブル

【１】CREATE TABLE

１）CREATE OR REPLACE TABLE

２）使用上の注意

【２】ALTER TABLE

１）ALTER TABLE ... ALTER COLUMN

２）ALTER TABLE ... DROP COLUMN

３）ALTER TABLE ... RENAME TO

４）使用上の注意

【３】補足１：テーブル定義確認

【４】補足２：外部テーブル

関連記事