Tratando novas colunas na saída do comando SHOW e nas exibições do Snowflake¶

Periodicamente, novas colunas são introduzidas na saída dos comandos SHOW <objetos> e nas exibições do Snowflake (como as do esquema ACCOUNT_USAGE no banco de dados SNOWFLAKE e as do esquema INFORMATION_SCHEMA).

Se você tem um script ou código que depende do conjunto de resultados que inclui um número específico de colunas ou que depende da ordem das colunas, a introdução de uma nova coluna pode afetar esse script ou código.

Solução alternativa de um problema introduzido por uma nova coluna¶

Se o seu script ou código encontrar problemas devido à introdução de novas colunas, seu administrador do Snowflake (um usuário a quem foi concedida a função ACCOUNTADMIN) pode alterar as colunas que são retornadas para execuções de um comando SHOW específico ou de consultas SELECT * de uma exibição do Snowflake. Essas colunas são chamadas de colunas padrão.

Substituindo as colunas padrão em um comando SHOW¶

Para excluir colunas recém-introduzidas da saída de um comando SHOW, chame a função SYSTEM$SET_DEFAULT_COLUMNS_OVERRIDE_FOR_SHOW_COMMAND, especificando o tipo de objeto e a lista de colunas que devem ser retornados.

Suponha que uma nova coluna direction foi introduzida na saída do comando SHOW NOTIFICATION INTEGRATIONS. Para impedir que a nova coluna direction seja incluída na saída do comando, chame SYSTEM$SET_DEFAULT_COLUMNS_OVERRIDE_FOR_SHOW_COMMAND, especificando 'NOTIFICATION INTEGRATIONS' como o tipo de objeto. Passe uma lista separada por vírgulas das colunas que devem ser retornadas na saída (uma lista que exclui direction):

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

Quando alguém em sua conta executar o comando SHOW NOTIFICATION INTEGRATIONS, a nova coluna direction não será retornada na saída.

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

Redefinindo as colunas padrão de um comando SHOW¶

Se você precisar desfazer uma chamada SYSTEM$SET_DEFAULT_COLUMNS_OVERRIDE_FOR_SHOW_COMMAND e retornar todas as colunas no comando SHOW para um tipo de objeto específico, chame a função SYSTEM$UNSET_DEFAULT_COLUMNS_OVERRIDE_FOR_SHOW_COMMAND, especificando o tipo de objeto. Por exemplo:

SELECT SYSTEM$UNSET_DEFAULT_COLUMNS_OVERRIDE_FOR_SHOW_COMMAND(
  'NOTIFICATION INTEGRATIONS'
);

Obtendo a lista de colunas padrão para um comando SHOW¶

Se você precisa determinar se SYSTEM$SET_DEFAULT_COLUMNS_OVERRIDE_FOR_SHOW_COMMAND foi chamado para um tipo de objeto específico e quer a lista de colunas que serão retornadas na saída do comando, chame a função SYSTEM$GET_DEFAULT_COLUMNS_OVERRIDE_FOR_SHOW_COMMAND, especificando o tipo de objeto. Por exemplo:

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

Se SYSTEM$SET_DEFAULT_COLUMNS_OVERRIDE_FOR_SHOW_COMMAND ainda não foi chamado ou se SYSTEM$UNSET_DEFAULT_COLUMNS_OVERRIDE_FOR_SHOW_COMMAND foi chamado, a função retorna uma cadeia de caracteres vazia.

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

Substituindo as colunas padrão em uma exibição do Snowflake¶

Para excluir colunas recém-introduzidas dos resultados de uma consulta SELECT * de uma exibição do Snowflake, chame a função SYSTEM$SET_DEFAULT_COLUMNS_OVERRIDE_FOR_SYSTEM_OBJECT, especificando o tipo de objeto, o banco de dados e o esquema que contêm a exibição, o nome da exibição e a lista de colunas que devem ser retornadas.

Suponha que uma nova coluna replicable_with_failover_groups foi introduzida na exibição DATABASES no esquema ACCOUNT_USAGE. Para impedir que a nova coluna replicable_with_failover_groups seja retornada nos resultados de uma consulta SELECT * da exibição, chame SYSTEM$SET_DEFAULT_COLUMNS_OVERRIDE_FOR_SYSTEM_OBJECT, especificando 'VIEW' como o tipo de objeto, 'SNOWFLAKE' como o banco de dados, 'ACCOUNT_USAGE' como o esquema e 'TABLES' como a exibição. Passe uma lista separada por vírgulas das colunas que devem ser retornadas na saída (uma lista que exclui 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'
);

O exemplo usa o operador || para construir uma cadeia de caracteres com a lista de colunas separadas por vírgulas.

Quando alguém em sua conta realiza uma consulta SELECT * da exibição DATABASES, a nova coluna replicable_with_failover_groups não é retornada na saída.

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

Se você precisa chamar essa função para uma exibição INFORMATION_SCHEMA, passe uma cadeia de caracteres vazia no lugar do nome do banco de dados. Por exemplo, para excluir a coluna replicable_with_failover_groups dos resultados das consultas SELECT * da exibição DATABASES no esquema INFORMATION_SCHEMA:

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

Redefinindo as colunas padrão em uma exibição do Snowflake¶

Se você precisa desfazer uma chamada SYSTEM$SET_DEFAULT_COLUMNS_OVERRIDE_FOR_SYSTEM_OBJECT anterior e retornar todas as colunas em uma consulta SELECT * de uma exibição do Snowflake, chame a função SYSTEM$UNSET_DEFAULT_COLUMNS_OVERRIDE_FOR_SYSTEM_OBJECT, especificando o tipo de objeto, o banco de dados e o esquema que contêm a exibição, e o nome da exibição. Por exemplo:

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

Se você precisa chamar essa função para uma exibição INFORMATION_SCHEMA, passe uma cadeia de caracteres vazia no lugar do nome do banco de dados. Por exemplo:

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

Obtendo a lista de colunas padrão em uma exibição do Snowflake¶

Se você precisa determinar se SYSTEM$SET_DEFAULT_COLUMNS_OVERRIDE_FOR_SYSTEM_OBJECT foi chamado para uma exibição específica e quer a lista das colunas que serão retornadas em uma consulta SELECT * dessa exibição, chame a função SYSTEM$GET_DEFAULT_COLUMNS_OVERRIDE_FOR_SYSTEM_OBJECT, especificando o tipo de objeto, o banco de dados e o esquema que contêm a exibição, e o nome da exibição. Por exemplo:

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

Se você precisa chamar essa função para uma exibição INFORMATION_SCHEMA, passe uma cadeia de caracteres vazia no lugar do nome do banco de dados. Por exemplo:

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

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

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

Obtendo a lista de colunas de todas as chamadas anteriores para comandos SHOW e exibições do Snowflake¶

Para obter a lista de colunas substituídas para todos os comandos SHOW e as exibições do Snowflake, chame a função SYSTEM$GET_ALL_DEFAULT_COLUMNS_OVERRIDES. Por exemplo:

SELECT SYSTEM$GET_ALL_DEFAULT_COLUMNS_OVERRIDES();

A função retorna uma cadeia de caracteres com uma matriz de objetos JSON. Cada objeto representa a lista de colunas para um comando SHOW específico ou uma exibição do Snowflake. Por exemplo:

+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| 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"}] |
+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+

Para ver uma explicação dos pares nome/valor em cada objeto, consulte SYSTEM$GET_ALL_DEFAULT_COLUMNS_OVERRIDES.

Atualizando scripts e código para impedir problemas quando novas colunas são introduzidas¶

Para impedir a ocorrência de problemas devido à introdução de novas colunas, seus scripts e código devem selecionar colunas específicas da saída dos comandos SHOW e ao consultar as exibições do Snowflake.

Para selecionar colunas específicas da saída dos comandos SHOW, você pode usar o operador de canal. Consulte o exemplo em Selecione uma lista de colunas para a saída de um comando SHOW.