カテゴリ：: システム関数（情報）

SYSTEM$GET_DEFAULT_COLUMNS_OVERRIDE_FOR_SYSTEM_OBJECT¶

指定したSnowflakeビューに関する（例: 特定の ACCOUNT_USAGE ビューまたは INFORMATION_SCHEMA ビューに関するもの）:doc:/sql-reference/functions/system_set_default_columns_override_for_system_object への以前の呼び出しによって設定された列のリストを返します。

詳細については、 SHOW コマンド出力とSnowflakeビューでの新しい列の処理をご参照ください。

こちらもご参照ください。: SYSTEM$SET_DEFAULT_COLUMNS_OVERRIDE_FOR_SYSTEM_OBJECT、 SYSTEM$UNSET_DEFAULT_COLUMNS_OVERRIDE_FOR_SYSTEM_OBJECT、 SYSTEM$GET_ALL_DEFAULT_COLUMNS_OVERRIDES

構文¶

SYSTEM$GET_DEFAULT_COLUMNS_OVERRIDE_FOR_SYSTEM_OBJECT(
  '<object_type>',
  '<database_name>',
  '<schema_name>',
  '<object_name>'
)

Copy

引数¶

'object_type': オブジェクトの型。この引数に対して 'VIEW' を指定する必要があります。
'database_name': オブジェクトを含むデータベースの名前。'SNOWFLAKE' を指定する必要があります。または、INFORMATION_SCHEMA ビューの場合は、空の文字列を指定する必要があります。
'schema_name': オブジェクトを含むスキーマの名前。SNOWFLAKE データベースまたは 'INFORMATION_SCHEMA' でスキーマの名前を指定する必要があります。
'object_name': オブジェクトの名前です。

戻り値¶

SYSTEM$SET_DEFAULT_COLUMNS_OVERRIDE_FOR_SYSTEM_OBJECT に対する以前の呼び出しで指定された列のコンマ区切りリストが含まれる VARCHAR 値を返します。列名は大文字です。

SYSTEM$SET_DEFAULT_COLUMNS_OVERRIDE_FOR_SYSTEM_OBJECT が呼び出されなかったか、列のリストをクリアするために SYSTEM$UNSET_DEFAULT_COLUMNS_OVERRIDE_FOR_SYSTEM_OBJECT が呼び出された場合、この関数は空の文字列を返します。

アクセス制御の要件¶

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

使用上の注意¶

この関数を呼び出すには、使用中のデータベースが必要です（例: USE DATABASE を呼び出すことによる）。使用中のデータベースがない場合、関数の呼び出しは失敗します。

例¶

次の例では、ACCOUNT_USAGE スキーマ </sql-reference/account-usage/tables>` の :doc:`TABLES ビューに関する以前の SYSTEM$SET_DEFAULT_COLUMNS_OVERRIDE_FOR_SYSTEM_OBJECT に対する呼び出しで指定された列のリストを返しています。

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

Copy

+--------------------------------------------------------+
| SYSTEM$GET_DEFAULT_COLUMNS_OVERRIDE_FOR_SYSTEM_OBJECT( |
|   'VIEW',                                              |
|   'SNOWFLAKE',                                         |
|   'ACCOUNT_USAGE',                                     |
|   'TABLES'                                             |
| )                                                      |
|--------------------------------------------------------|
| TABLE_NAME,TABLE_SCHEMA,TABLE_TYPE                     |
+--------------------------------------------------------+

次の例では、INFORMATION_SCHEMA スキーマ </sql-reference/info-schema/tables>` の :doc:`TABLES ビューに関する以前の SYSTEM$SET_DEFAULT_COLUMNS_OVERRIDE_FOR_SYSTEM_OBJECT に対する呼び出しで指定された列のリストを返しています。

SELECT SYSTEM$GET_DEFAULT_COLUMNS_OVERRIDE_FOR_SYSTEM_OBJECT(
  'VIEW',
  '',
  'ACCOUNT_USAGE',
  'TABLES'
);

Copy

+--------------------------------------------------------+
| SYSTEM$GET_DEFAULT_COLUMNS_OVERRIDE_FOR_SYSTEM_OBJECT( |
|   'VIEW',                                              |
|   '',                                                  |
|   'INFORMATION_SCHEMA',                                |
|   'TABLES'                                             |
| )                                                      |
|--------------------------------------------------------|
| TABLE_NAME,TABLE_SCHEMA,TABLE_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',
  'TABLES'
);

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

Copy

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