カテゴリ：

システム関数 （制御）

SYSTEM$SET_DEFAULT_COLUMNS_OVERRIDE_FOR_SHOW_COMMAND

指定した SHOW <オブジェクト> コマンドを実行した際に返される必要がある列を制御します。

SHOW COMMAND に新しい列が導入されたことで、結果の列の固定数または順序に依存するスクリプトまたはコードに問題が発生した場合は、この関数を呼び出すことができます。SHOW コマンド出力とSnowflakeビューでの新しい列の処理 をご参照ください。

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

SYSTEM$GET_DEFAULT_COLUMNS_OVERRIDE_FOR_SHOW_COMMAND、 SYSTEM$UNSET_DEFAULT_COLUMNS_OVERRIDE_FOR_SHOW_COMMAND、 SYSTEM$GET_ALL_DEFAULT_COLUMNS_OVERRIDES

構文

SYSTEM$SET_DEFAULT_COLUMNS_OVERRIDE_FOR_SHOW_COMMAND(
  '<object_type>',
  '<list_of_columns>'
)
Copy

引数

'object_type'

SHOW コマンドのオブジェクトの型。たとえば、SHOW TABLES コマンドの場合は、'TABLES' を指定します。SHOW NOTIFICATION INTEGRATIONS コマンドの場合は、'NOTIFICATION INTEGRATIONS' を指定します。

list_of_columns

SHOW コマンドの出力で返される必要がある列のコンマ区切りまたはスペース区切りのリスト。

列名は、大文字、小文字、または大文字と小文字の組み合わせで指定できます。

すべての列が返されるようにするには、空の文字列を指定するか、SYSTEM$UNSET_DEFAULT_COLUMNS_OVERRIDE_FOR_SHOW_COMMAND を呼び出します。

戻り値

操作が成功した場合は TRUE が返されます。

アクセス制御の要件

アカウント管理者（ACCOUNTADMIN ロールを付与されているユーザー）のみが、この関数を呼び出すことができます。

例

次の例では、name 列、database_name 列、kind および comment 列のみを返すように SHOW TABLES コマンドを構成しています。

SELECT SYSTEM$SET_DEFAULT_COLUMNS_OVERRIDE_FOR_SHOW_COMMAND(
  'TABLES',
  'name, database_name, kind, comment'
);
Copy

SHOW TABLES コマンドを実行すると、指定した列のみが返されます。

SHOW TABLES;
Copy
+------------------+---------------+-------+---------+
| name             | database_name | kind  | comment |
|------------------+---------------+-------+---------|
| DEPARTMENT_TABLE | MY_DB         | TABLE |         |
| EMPLOYEE_TABLE   | MY_DB         | TABLE |         |
+------------------+---------------+-------+---------+

SHOW TERSE TABLES コマンドを実行すると、TERSE を指定した場合は通常返されない comment を除く、指定した列のみが返されます。

SHOW TERSE TABLES;
Copy
+------------------+-------+---------------+
| name             | kind  | database_name |
|------------------+-------+---------------|
| DEPARTMENT_TABLE | TABLE | MY_DB         |
| EMPLOYEE_TABLE   | TABLE | MY_DB         |
+------------------+-------+---------------+