Catégories :: Fonctions système (Contrôle)

SYSTEM$SET_DEFAULT_COLUMNS_OVERRIDE_FOR_SHOW_COMMAND¶

Contrôle les colonnes qui doivent être retournées lorsque la commande SHOW <objets> spécifiée est exécutée.

Vous pouvez appeler cette fonction si l’introduction de nouvelles colonnes dans une COMMAND SHOW introduit un problème avec un script ou un code qui dépend d’un nombre fixe ou d’un ordre de colonnes dans les résultats. Voir Gestion des nouvelles colonnes dans la sortie d’une commande SHOW et les vues Snowflake.

Voir aussi :: SYSTEM$GET_DEFAULT_COLUMNS_OVERRIDE_FOR_SHOW_COMMAND, SYSTEM$UNSET_DEFAULT_COLUMNS_OVERRIDE_FOR_SHOW_COMMAND, SYSTEM$GET_ALL_DEFAULT_COLUMNS_OVERRIDES

Syntaxe¶

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

Copy

Arguments¶

'object_type'

Type d’objet pour la commande SHOW. Par exemple, pour la commande SHOW TABLES, spécifiez 'TABLES'. Pour la commande SHOW NOTIFICATION INTEGRATIONS, spécifiez 'NOTIFICATION INTEGRATIONS'.

list_of_columns

Liste des colonnes, séparées par des virgules ou des espaces, qui doivent être renvoyées dans la sortie de la commande SHOW.

Vous pouvez spécifier les noms des colonnes en majuscules, en minuscules ou en caractères mixtes.

Pour renvoyer toutes les colonnes, spécifiez une chaîne vide ou appelez SYSTEM$UNSET_DEFAULT_COLUMNS_OVERRIDE_FOR_SHOW_COMMAND.

Renvoie¶

Renvoie TRUE si l’opération a réussi.

Exigences en matière de contrôle d’accès¶

Seuls les administrateurs de compte (utilisateurs qui ont reçu le rôle ACCOUNTADMIN) peuvent appeler cette fonction.

Exemples¶

L’exemple suivant configure la commande SHOW TABLES pour ne renvoyer que les colonnes name, database_name, kind et comment :

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

Copy

Exécuter la commande SHOW TABLES renvoie uniquement les colonnes spécifiées :

SHOW TABLES;

Copy

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

Exécuter la commande SHOW TERSE TABLES renvoie uniquement les colonnes spécifiées à l’exception de comment, qui n’est normalement pas renvoyé lorsque vous spécifiez TERSE :

SHOW TERSE TABLES;

Copy

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