Categorias:: Funções do sistema (Informação)

SYSTEM$GET_DEFAULT_COLUMNS_OVERRIDE_FOR_SYSTEM_OBJECT¶

Retorna a lista de colunas que foram definidas por uma chamada anterior para SYSTEM$SET_DEFAULT_COLUMNS_OVERRIDE_FOR_SYSTEM_OBJECT para a exibição especificada do Snowflake (por exemplo, para uma exibição ACCOUNT_USAGE ou uma exibição INFORMATION_SCHEMA especificada).

Para obter mais informações, consulte Tratando novas colunas na saída do comando SHOW e nas exibições do Snowflake.

Consulte também:: SYSTEM$SET_DEFAULT_COLUMNS_OVERRIDE_FOR_SYSTEM_OBJECT, SYSTEM$UNSET_DEFAULT_COLUMNS_OVERRIDE_FOR_SYSTEM_OBJECT, SYSTEM$GET_ALL_DEFAULT_COLUMNS_OVERRIDES

Sintaxe¶

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

Copy

Argumentos¶

'object_type': Tipo do objeto. Você deve especificar 'VIEW' para este argumento.
'database_name': Nome do banco de dados que contém o objeto. Você deve especificar 'SNOWFLAKE' ou, para exibições INFORMATION_SCHEMA, uma cadeia de caracteres vazia.
'schema_name': Nome do esquema que contém o objeto. Você deve especificar o nome de um esquema no banco de dados SNOWFLAKE ou 'INFORMATION_SCHEMA'.
'object_name': Nome do objeto.

Retornos¶

Retorna um valor VARCHAR com uma lista separada por vírgulas das colunas especificadas pela chamada anterior para SYSTEM$SET_DEFAULT_COLUMNS_OVERRIDE_FOR_SYSTEM_OBJECT. Os nomes das colunas estão em maiúsculas.

Se SYSTEM$SET_DEFAULT_COLUMNS_OVERRIDE_FOR_SYSTEM_OBJECT não foi chamado ou se SYSTEM$UNSET_DEFAULT_COLUMNS_OVERRIDE_FOR_SYSTEM_OBJECT foi chamado para limpar a lista de colunas, a função retorna uma cadeia de caracteres vazia.

Requisitos de controle de acesso¶

Somente administradores de conta (usuários a quem foi concedida a função ACCOUNTADMIN) podem chamar essa função.

Notas de uso¶

Você deve ter um banco de dados em uso (por exemplo, executando USE DATABASE) para chamar esta função. Se nenhum banco de dados estiver em uso, a chamada de função falhará.

Exemplos¶

O exemplo a seguir retorna a lista de colunas especificadas por uma chamada anterior para SYSTEM$SET_DEFAULT_COLUMNS_OVERRIDE_FOR_SYSTEM_OBJECTpara a exibição TABLES no esquema ACCOUNT_USAGE:

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                     |
+--------------------------------------------------------+

O exemplo a seguir retorna a lista de colunas especificadas por uma chamada anterior para SYSTEM$SET_DEFAULT_COLUMNS_OVERRIDE_FOR_SYSTEM_OBJECTpara a exibição TABLES no esquema INFORMATION_SCHEMA:

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                     |
+--------------------------------------------------------+

Se SYSTEM$SET_DEFAULT_COLUMNS_OVERRIDE_FOR_SYSTEM_OBJECT não foi chamado ou se SYSTEM$UNSET_DEFAULT_COLUMNS_OVERRIDE_FOR_SYSTEM_OBJECT foi chamado para limpar a lista, a função retorna uma cadeia de caracteres vazia:

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'                                             |
| )                                                      |
|--------------------------------------------------------|