Catégories :: Fonctions système (informations)

SYSTEM$GET_DEFAULT_COLUMNS_OVERRIDE_FOR_SYSTEM_OBJECT¶

Renvoie la liste des colonnes qui ont été définies par un appel précédent à SYSTEM$SET_DEFAULT_COLUMNS_OVERRIDE_FOR_SYSTEM_OBJECT pour la vue Snowflake spécifiée (par exemple, pour une vue ACCOUNT_USAGE ou vue :doc:`INFORMATION_SCHEMA </sql-reference/info-schema>`spécifique).

Pour plus d’informations, voir Gestion des nouvelles colonnes dans la sortie d’une commande SHOW et les vues Snowflake.

Voir aussi :: SYSTEM$SET_DEFAULT_COLUMNS_OVERRIDE_FOR_SYSTEM_OBJECT, SYSTEM$UNSET_DEFAULT_COLUMNS_OVERRIDE_FOR_SYSTEM_OBJECT, SYSTEM$GET_ALL_DEFAULT_COLUMNS_OVERRIDES

Syntaxe¶

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

Copy

Arguments¶

'object_type': Type de l’objet. Vous devez spécifier 'VIEW' pour cet argument.
'database_name': Nom de la base de données contenant l’objet. Vous devez spécifier 'SNOWFLAKE' ou, pour les vues INFORMATION_SCHEMA, une chaîne vide.
'schema_name': Nom du schéma contenant l’objet. Vous devez spécifier le nom d’un schéma dans la base de données SNOWFLAKE ou 'INFORMATION_SCHEMA'.
'object_name': Nom de l’objet.

Renvoie¶

Renvoie une valeur VARCHAR contenant une liste séparée par des virgules des colonnes spécifiées par l’appel précédent à SYSTEM$SET_DEFAULT_COLUMNS_OVERRIDE_FOR_SYSTEM_OBJECT. Les noms des colonnes sont en majuscules.

Si la fonction SYSTEM$SET_DEFAULT_COLUMNS_OVERRIDE_FOR_SYSTEM_OBJECT n’a pas été appelée ou si la fonction SYSTEM$UNSET_DEFAULT_COLUMNS_OVERRIDE_FOR_SYSTEM_OBJECT a été appelée pour effacer la liste des colonnes, la fonction renvoie une chaîne vide.

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.

Notes sur l’utilisation¶

Vous devez avoir une base de données en cours d’utilisation (par exemple, en exécutant USE DATABASE) pour appeler cette fonction. Si aucune base de données n’est utilisée, l’appel de la fonction échoue.

Exemples¶

L’exemple suivant renvoie la liste des colonnes spécifiées par un appel précédent à SYSTEM$SET_DEFAULT_COLUMNS_OVERRIDE_FOR_SYSTEM_OBJECT pour la vue TABLES dans le schéma 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                     |
+--------------------------------------------------------+

L’exemple suivant renvoie la liste des colonnes spécifiées par un appel précédent à SYSTEM$SET_DEFAULT_COLUMNS_OVERRIDE_FOR_SYSTEM_OBJECT pour la vue TABLES dans le schéma 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                     |
+--------------------------------------------------------+

Si SYSTEM$SET_DEFAULT_COLUMNS_OVERRIDE_FOR_SYSTEM_OBJECT n’a pas été appelé ou si SYSTEM$UNSET_DEFAULT_COLUMNS_OVERRIDE_FOR_SYSTEM_OBJECT a été appelé pour effacer la liste, la fonction renvoie une chaîne vide :

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