SHOW コマンド出力とSnowflakeビューでの新しい列の処理¶

SHOW <オブジェクト> コマンドの出力とSnowflakeビュー（SNOWFLAKE データベースの ACCOUNT_USAGE スキーマおよび INFORMATION_SCHEMA スキーマのビューなど）に定期的に新しい列が導入されます。

特定の数の列を含む結果セットに依存するスクリプトやコードがある場合、または列の順序に依存するスクリプトやコードがある場合は、新しい列の導入により、そのスクリプトやコードに影響が生じる可能性があります。

新しい列によって導入された問題の一時的な回避¶

新しい列の導入によってスクリプトまたはコードに問題が発生した場合、Snowflake管理者（ACCOUNTADMIN ロールが付与されたユーザー）は、特定の SHOW コマンドまたはSnowflakeビューの SELECT * クエリの実行に対して返される列を変更できます。これらの列は、デフォルト列 と呼ばれます。

SHOW コマンドのデフォルト列の上書き¶

新しく導入された列を SHOW コマンドの出力から除外するには、 SYSTEM$SET_DEFAULT_COLUMNS_OVERRIDE_FOR_SHOW_COMMAND 関数を呼び出し、オブジェクトの型と返される必要のある列のリストを指定します。

新しい direction 列が SHOW NOTIFICATION INTEGRATIONS コマンド出力に導入されたとします。コマンドの出力に新しい direction 列が含まれるのを防ぐには、 SYSTEM$SET_DEFAULT_COLUMNS_OVERRIDE_FOR_SHOW_COMMAND を呼び出し、 'NOTIFICATION INTEGRATIONS' をオブジェクトの型として指定します。出力で返される必要がある列のコンマ区切りリストを渡します（direction を除外したリスト）：

SELECT SYSTEM$SET_DEFAULT_COLUMNS_OVERRIDE_FOR_SHOW_COMMAND(
  'NOTIFICATION INTEGRATIONS',
  'name, type, category, enabled, comment, created_on'
);

アカウントのユーザーが SHOWNOTIFICATIONINTEGRATIONS コマンドを実行すると、新しい direction 列は出力に返されません。

SHOW NOTIFICATION INTEGRATIONS;

+--------------------------------+---------+--------------+---------+---------+-------------------------------+
| name                           | type    | category     | enabled | comment | created_on                    |
|--------------------------------+---------+--------------+---------+---------+-------------------------------|
| SLACK_NOTIFICATION_INTEGRATION | WEBHOOK | NOTIFICATION | true    | NULL    | 2025-07-02 06:14:53.859 -0700 |
+--------------------------------+---------+--------------+---------+---------+-------------------------------+

SHOW コマンドのデフォルト列のリセット¶

以前の SYSTEM$SET_DEFAULT_COLUMNS_OVERRIDE_FOR_SHOW_COMMAND 呼び出しを取り消して、特定のオブジェクトの型について SHOW コマンドのすべての列を返す必要がある場合は、オブジェクトの型を指定して SYSTEM$UNSET_DEFAULT_COLUMNS_OVERRIDE_FOR_SHOW_COMMAND 関数を呼び出します。例:

SELECT SYSTEM$UNSET_DEFAULT_COLUMNS_OVERRIDE_FOR_SHOW_COMMAND(
  'NOTIFICATION INTEGRATIONS'
);

SHOW コマンドのデフォルト列のリストの取得¶

特定のオブジェクトの型に対して SYSTEM$SET_DEFAULT_COLUMNS_OVERRIDE_FOR_SHOW_COMMAND が呼び出されたかどうかを確認し、コマンドの出力で返される列のリストが必要な場合は、オブジェクトの型を指定して SYSTEM$GET_DEFAULT_COLUMNS_OVERRIDE_FOR_SHOW_COMMAND 関数を呼び出します。例:

SELECT SYSTEM$GET_DEFAULT_COLUMNS_OVERRIDE_FOR_SHOW_COMMAND(
  'NOTIFICATION INTEGRATIONS'
);

+-------------------------------------------------------+
| SYSTEM$GET_DEFAULT_COLUMNS_OVERRIDE_FOR_SHOW_COMMAND( |
|   'NOTIFICATION INTEGRATIONS'                         |
| )                                                     |
|-------------------------------------------------------|
| name,type,category,enabled,comment,created_on         |
+-------------------------------------------------------+

SYSTEM$SET_DEFAULT_COLUMNS_OVERRIDE_FOR_SHOW_COMMAND が以前に呼び出されなかったか、 SYSTEM$UNSET_DEFAULT_COLUMNS_OVERRIDE_FOR_SHOW_COMMAND が呼び出された場合、関数は空の文字列を返します。

SELECT SYSTEM$UNSET_DEFAULT_COLUMNS_OVERRIDE_FOR_SHOW_COMMAND(
  'NOTIFICATION INTEGRATIONS'
);

SELECT SYSTEM$GET_DEFAULT_COLUMNS_OVERRIDE_FOR_SHOW_COMMAND(
  'NOTIFICATION INTEGRATIONS'
);

+-------------------------------------------------------+
| SYSTEM$GET_DEFAULT_COLUMNS_OVERRIDE_FOR_SHOW_COMMAND( |
|   'NOTIFICATION INTEGRATIONS'                         |
| )                                                     |
|-------------------------------------------------------|
|                                                       |
+-------------------------------------------------------+

Snowflakeビューのデフォルト列の上書き¶

Snowflakeビュー SELECT * クエリの結果から新しく導入された列を除外するには、 SYSTEM$SET_DEFAULT_COLUMNS_OVERRIDE_FOR_SYSTEM_OBJECT 関数を呼び出し、オブジェクトの型、ビューを含むデータベースとスキーマ、ビューの名前、返される必要のある列のリストを指定します。

ACCOUNT_USAGE スキーマ</sql-reference/account-usage/databases>` 内の DATABASES ビューに新しい ``replicable_with_failover_groups` 列が導入されたとします。ビューの SELECT * クエリの結果に新しい replicable_with_failover_groups 列が返されないようにするには、オブジェクトの型として 'VIEW'、データベースとして 'SNOWFLAKE'、スキーマとして 'ACCOUNT_USAGE'、ビューとして 'TABLES' を指定して、 SYSTEM$SET_DEFAULT_COLUMNS_OVERRIDE_FOR_SYSTEM_OBJECT を呼び出します。出力で返される必要がある列のコンマ区切りリストを渡します（replicable_with_failover_groups を除外したリスト）：

SELECT SYSTEM$SET_DEFAULT_COLUMNS_OVERRIDE_FOR_SYSTEM_OBJECT(
  'VIEW',
  'SNOWFLAKE',
  'ACCOUNT_USAGE',
  'DATABASES',
  'database_id, database_name, database_owner, is_transient, ' ||
  'comment, created, last_altered, deleted, retention_time, '  ||
  'resource_group, type, owner_role_type, object_visibility'
);

この例では、 || 演算子を使用して、コンマ区切りリストを含む文字列を構築します。

アカウント内の誰かが DATABASES ビューの SELECT * クエリを実行しても、新しい replicable_with_failover_groups 列は出力に返されません。

SELECT * FROM SNOWFLAKE.ACCOUNT_USAGE.DATABASES;

+-------------+---------------+----------------+--------------+---------+-------------------------------+-------------------------------+-------------------------------+----------------+----------------+----------+-----------------+-------------------+
| DATABASE_ID | DATABASE_NAME | DATABASE_OWNER | IS_TRANSIENT | COMMENT | CREATED                       | LAST_ALTERED                  | DELETED                       | RETENTION_TIME | RESOURCE_GROUP | TYPE     | OWNER_ROLE_TYPE | OBJECT_VISIBILITY |
|-------------+---------------+----------------+--------------+---------+-------------------------------+-------------------------------+-------------------------------+----------------+----------------+----------+-----------------+-------------------|
|          55 | MY_DATABASE   | NULL           | NO           | NULL    | 2025-07-16 15:17:55.990 -0700 | 2025-07-17 15:19:52.305 -0700 | 2025-07-16 15:18:32.973 -0700 |              1 | NULL           | STANDARD | NULL            | NULL              |
+-------------+---------------+----------------+--------------+---------+-------------------------------+-------------------------------+-------------------------------+----------------+----------------+----------+-----------------+-------------------+

INFORMATION_SCHEMA ビューに対してこの関数を呼び出す必要がある場合、データベース名に空の文字列を渡します。たとえば、 INFORMATION_SCHEMA スキーマ</sql-reference/info-schema/databases>` の DATABASES ビューの :code:`SELECT * クエリの結果から replicable_with_failover_groups 列を除外するには、次のようにします。

SELECT SYSTEM$SET_DEFAULT_COLUMNS_OVERRIDE_FOR_SYSTEM_OBJECT(
  'VIEW',
  '',
  'INFORMATION_SCHEMA',
  'DATABASES',
  'database_name, database_owner, is_transient, comment, ' ||
  'created, last_altered, retention_time, type, '          ||
  'owner_role_type'
);

Snowflakeビューのデフォルト列のリセット¶

以前の SYSTEM$SET_DEFAULT_COLUMNS_OVERRIDE_FOR_SYSTEM_OBJECT 呼び出しを元に戻してSnowflakeビューの SELECT * クエリ内のすべての列を返す場合、 SYSTEM$UNSET_DEFAULT_COLUMNS_OVERRIDE_FOR_SYSTEM_OBJECT 関数を呼び出し、オブジェクトの型、ビューを含むデータベースとスキーマ、ビューの名前を指定します。例:

SELECT SYSTEM$UNSET_DEFAULT_COLUMNS_OVERRIDE_FOR_SYSTEM_OBJECT(
  'VIEW',
  'SNOWFLAKE',
  'ACCOUNT_USAGE',
  'DATABASES'
);

INFORMATION_SCHEMA ビューに対してこの関数を呼び出す必要がある場合、データベース名に空の文字列を渡します。例:

SELECT SYSTEM$UNSET_DEFAULT_COLUMNS_OVERRIDE_FOR_SYSTEM_OBJECT(
  'VIEW',
  '',
  'INFORMATION_SCHEMA',
  'DATABASES'
);

Snowflakeビューのデフォルト列のリスト取得¶

特定のビューに対して SYSTEM$SET_DEFAULT_COLUMNS_OVERRIDE_FOR_SYSTEM_OBJECT が呼び出されたかどうかを確認し、そのビューの SELECT * クエリで返される列のリストが必要な場合は、オブジェクトの型、ビューを含むデータベースとスキーマ、およびビューの名前を指定して SYSTEM$GET_DEFAULT_COLUMNS_OVERRIDE_FOR_SYSTEM_OBJECT 関数を呼び出します。例:

SELECT SYSTEM$GET_DEFAULT_COLUMNS_OVERRIDE_FOR_SYSTEM_OBJECT(
  'VIEW',
  'SNOWFLAKE',
  'ACCOUNT_USAGE',
  'DATABASES'
);

+-----------------------------------------------------------------------------------------------------------------------------------------------------------------+
| SYSTEM$GET_DEFAULT_COLUMNS_OVERRIDE_FOR_SYSTEM_OBJECT(                                                                                                          |
|   'VIEW',                                                                                                                                                       |
|   'SNOWFLAKE',                                                                                                                                                  |
|   'ACCOUNT_USAGE',                                                                                                                                              |
|   'DATABASES'                                                                                                                                                   |
| )                                                                                                                                                               |
|-----------------------------------------------------------------------------------------------------------------------------------------------------------------|
| DATABASE_ID,DATABASE_NAME,DATABASE_OWNER,IS_TRANSIENT,COMMENT,CREATED,LAST_ALTERED,DELETED,RETENTION_TIME,RESOURCE_GROUP,TYPE,OWNER_ROLE_TYPE,OBJECT_VISIBILITY |
+-----------------------------------------------------------------------------------------------------------------------------------------------------------------+

INFORMATION_SCHEMA ビューに対してこの関数を呼び出す必要がある場合、データベース名に空の文字列を渡します。例:

SELECT SYSTEM$GET_DEFAULT_COLUMNS_OVERRIDE_FOR_SYSTEM_OBJECT(
  'VIEW',
  '',
  'INFORMATION_SCHEMA',
  'DATABASES'
);

+------------------------------------------------------------------------------------------------------------+
| SYSTEM$GET_DEFAULT_COLUMNS_OVERRIDE_FOR_SYSTEM_OBJECT(                                                     |
|   'VIEW',                                                                                                  |
|   '',                                                                                                      |
|   'INFORMATION_SCHEMA',                                                                                    |
|   'DATABASES'                                                                                              |
| )                                                                                                          |
|------------------------------------------------------------------------------------------------------------|
| DATABASE_NAME,DATABASE_OWNER,IS_TRANSIENT,COMMENT,CREATED,LAST_ALTERED,RETENTION_TIME,TYPE,OWNER_ROLE_TYPE |
+------------------------------------------------------------------------------------------------------------+

SYSTEM$SET_DEFAULT_COLUMNS_OVERRIDE_FOR_SYSTEM_OBJECT が以前に呼び出されなかったか、 SYSTEM$UNSET_DEFAULT_COLUMNS_OVERRIDE_FOR_SYSTEM_OBJECT が呼び出された場合、関数は空の文字列を返します。

SELECT SYSTEM$UNSET_DEFAULT_COLUMNS_OVERRIDE_FOR_SYSTEM_OBJECT(
  'VIEW',
  'SNOWFLAKE',
  'ACCOUNT_USAGE',
  'DATABASES'
);

SELECT SYSTEM$GET_DEFAULT_COLUMNS_OVERRIDE_FOR_SYSTEM_OBJECT(
  'VIEW',
  'SNOWFLAKE',
  'ACCOUNT_USAGE',
  'DATABASES'
);

+--------------------------------------------------------+
| SYSTEM$GET_DEFAULT_COLUMNS_OVERRIDE_FOR_SYSTEM_OBJECT( |
|   'VIEW',                                              |
|   'SNOWFLAKE',                                         |
|   'ACCOUNT_USAGE',                                     |
|   'DATABASES'                                          |
| )                                                      |
|--------------------------------------------------------|
|                                                        |
+--------------------------------------------------------+

SHOW コマンドとSnowflakeビューの以前のすべての呼び出しからの列のリスト取得¶

すべての SHOW コマンドとSnowflakeビューに対して上書きされる列のリストを取得するには、 SYSTEM$GET_ALL_DEFAULT_COLUMNS_OVERRIDES 関数を呼び出します。例:

SELECT SYSTEM$GET_ALL_DEFAULT_COLUMNS_OVERRIDES();

関数は、オブジェクトの JSON 配列を含む文字列を返します。各オブジェクトは、特定の SHOW コマンドまたは Snowflakeビュー列のリストを表します。例:

+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| SYSTEM$GET_ALL_DEFAULT_COLUMNS_OVERRIDES()                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| [{"domain":"VIEW","isShowCommand":false,"dbName":"","schemaName":"INFORMATION_SCHEMA","objectName":"DATABASES","serializedDefaultColumns":"DATABASE_NAME,DATABASE_OWNER,IS_TRANSIENT,COMMENT,CREATED,LAST_ALTERED,RETENTION_TIME,TYPE,OWNER_ROLE_TYPE"},{"domain":"VIEW","isShowCommand":false,"dbName":"SNOWFLAKE","schemaName":"ACCOUNT_USAGE","objectName":"DATABASES","serializedDefaultColumns":"DATABASE_ID,DATABASE_NAME,DATABASE_OWNER,IS_TRANSIENT,COMMENT,CREATED,LAST_ALTERED,DELETED,RETENTION_TIME,RESOURCE_GROUP,TYPE,OWNER_ROLE_TYPE,OBJECT_VISIBILITY"},{"isShowCommand":true,"showCommandType":"NOTIFICATION INTEGRATIONS","serializedDefaultColumns":"name,type,category,enabled,comment,created_on"}] |
+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+

各オブジェクトの名前/値のペアの説明については、 SYSTEM$GET_ALL_DEFAULT_COLUMNS_OVERRIDES をご参照ください。

新しい列が導入されたときに問題を防ぐためのスクリプトとコードの更新¶

新しい列の導入によって問題が発生しないようにするには、スクリプトとコードで、 SHOW コマンドの出力から、およびSnowflakeビューをクエリするときに特定の列を選択する必要があります。

SHOW コマンドの出力から特定の列を選択するにはパイプ演算子を使用できます。SHOW コマンドの出力用に列のリストを選択するの例をご参照ください。