Categorias:: Funções do sistema (Controle)

SYSTEM$SET_DEFAULT_COLUMNS_OVERRIDE_FOR_SHOW_COMMAND¶

Controla as colunas que devem ser retornadas quando o comando SHOW <objetos> especificado é executado.

Você pode chamar essa função se a introdução de novas colunas em SHOW COMMAND introduz um problema com um script ou código que depende de um número ou de uma ordem fixa de colunas nos resultados. Consulte Tratando novas colunas na saída do comando SHOW e nas exibições do Snowflake.

Consulte também:: SYSTEM$GET_DEFAULT_COLUMNS_OVERRIDE_FOR_SHOW_COMMAND, SYSTEM$UNSET_DEFAULT_COLUMNS_OVERRIDE_FOR_SHOW_COMMAND, SYSTEM$GET_ALL_DEFAULT_COLUMNS_OVERRIDES

Sintaxe¶

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

Copy

Argumentos¶

'object_type'

Tipo de objeto para o comando SHOW. Por exemplo, para o comando SHOW TABLES, especifique 'TABLES'. Para o comando SHOW NOTIFICATION INTEGRATIONS, especifique 'NOTIFICATION INTEGRATIONS'.

list_of_columns

Lista de colunas separadas por vírgulas ou por espaços que devem ser retornadas na saída do comando SHOW.

Você pode especificar os nomes das colunas em maiúsculas, minúsculas ou uma mistura de maiúsculas e minúsculas.

Para retornar todas as colunas, especifique uma cadeia de caracteres vazia ou chame SYSTEM$UNSET_DEFAULT_COLUMNS_OVERRIDE_FOR_SHOW_COMMAND.

Retornos¶

Retorna TRUE se a operação foi bem-sucedida.

Requisitos de controle de acesso¶

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

Exemplos¶

O exemplo a seguir configura o comando SHOW TABLES para retornar apenas as colunas name, database_name, kind e comment:

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

Copy

Executar o comando SHOW TABLES retorna somente as colunas especificadas:

SHOW TABLES;

Copy

+------------------+---------------+-------+---------+
| name             | database_name | kind  | comment |
|------------------+---------------+-------+---------|
| DEPARTMENT_TABLE | MY_DB         | TABLE |         |
| EMPLOYEE_TABLE   | MY_DB         | TABLE |         |
+------------------+---------------+-------+---------+

Executar o comando SHOW TERSE TABLES retorna somente as colunas especificadas, exceto comment, que normalmente não é retornada quando você especifica TERSE:

SHOW TERSE TABLES;

Copy

+------------------+-------+---------------+
| name             | kind  | database_name |
|------------------+-------+---------------|
| DEPARTMENT_TABLE | TABLE | MY_DB         |
| EMPLOYEE_TABLE   | TABLE | MY_DB         |
+------------------+-------+---------------+