ALTER FUNCTION (DMF)¶

Syntaxe¶

ALTER FUNCTION [ IF EXISTS ] <name> ( TABLE ( <col_data_type> [ , ... ] ) )
  RENAME TO <new_name>

ALTER FUNCTION [ IF EXISTS ] <name> ( TABLE ( <col_data_type> [ , ... ] ) )
  SET SECURE

ALTER FUNCTION [ IF EXISTS ] <name> ( TABLE ( <col_data_type> [ , ... ] ) )
  UNSET SECURE

ALTER FUNCTION [ IF EXISTS ] <name> ( TABLE ( <col_data_type> [ , ... ] ) )
  SET COMMENT = '<string_literal>'

ALTER FUNCTION [ IF EXISTS ] <name> ( TABLE ( <col_data_type> [ , ... ] ) )
  UNSET COMMENT

ALTER FUNCTION [ IF EXISTS ] <name> ( TABLE ( <col_data_type> [ , ... ] ) )
  SET TAG <tag_name> = '<tag_value>' [ , <tag_name> = '<tag_value>' ... ]

ALTER FUNCTION [ IF EXISTS ] <name> ( TABLE ( <col_data_type> [ , ... ] ) )
  UNSET TAG <tag_name> [ , <tag_name> ... ]

Paramètres¶

name

Indique l’identifiant de l’DMF à modifier.

Si l’identificateur contient des espaces ou des caractères spéciaux, toute la chaîne doit être délimitée par des guillemets doubles. Les identificateurs entre guillemets doubles sont également sensibles à la casse.

Pour plus d’informations, voir Exigences relatives à l’identificateur.

TABLE( col_data_type [ , ... ] )

Spécifie le type de données du ou des colonnes du ou des arguments de la DMF. Les types d’argument sont nécessaires, parce que les DMFs prennent en charge la surcharge de noms, où deux DMFs du même schéma peuvent avoir le même nom. Les types de données d’argument sont utilisés pour identifier la DMF à modifier.

RENAME TO new_name

Spécifie le nouvel identifiant pour l’DMF ; la combinaison de l’identifiant et des types de données d’argument existants doit être unique pour le schéma.

Pour plus d’informations, voir Exigences relatives à l’identificateur.

Note

Lorsque vous spécifiez le nouveau nom de l’UDF, ne spécifiez pas de types de données d’argument ni de parenthèses ; spécifiez uniquement le nouveau nom.

Vous pouvez déplacer l’objet vers une autre base de données et/ou un autre schéma tout en renommant éventuellement l’objet. Pour ce faire, spécifiez une valeur new_name qualifiée qui inclut le nouveau nom de la base de données et/ou du schéma sous la forme db_name.schema_name.object_name ou schema_name.object_name, respectivement.

Note

• La base de données et/ou le schéma de destination doivent déjà exister. En outre, un objet portant le même nom ne peut pas déjà exister dans le nouvel emplacement ; sinon, l’instruction renvoie une erreur.

• Le déplacement d’un objet vers un schéma d’accès géré est interdit sauf si le propriétaire de l’objet (c’est-à-dire le rôle qui a le privilège OWNERSHIP sur l’objet) est également propriétaire du schéma cible.

Lorsqu’un objet est renommé, les autres objets qui le référencent doivent être mis à jour avec le nouveau nom.

SET ...

Spécifie les propriétés à définir pour la DMF :

SECURE

Indique si une fonction est sécurisée. Pour plus d’informations, voir Protection des informations sensibles avec les UDFs et les procédures stockées sécurisées.

COMMENT = 'string_literal'

Ajoute un commentaire ou écrase le commentaire existant pour la fonction. La valeur que vous spécifiez est affichée dans la colonne DESCRIPTION de la sortie SHOW FUNCTIONS et SHOW USER FUNCTIONS.

TAG tag_name = 'tag_value' [ , tag_name = 'tag_value' , ... ]

Spécifie le nom de la balise et la valeur de la chaîne de la balise.

La valeur de la balise est toujours une chaîne de caractères et le nombre maximum de caractères pour la valeur de la balise est 256.

Pour plus d’informations sur la spécification des balises dans une instruction, voir Quotas de balises pour les objets et les colonnes.

UNSET ...

Spécifie les propriétés à désactiver pour la fonction, qui les réinitialise aux valeurs par défaut.

• SECURE

• COMMENT

• TAG tag_name [ , tag_name ... ]

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

Un rôle utilisé pour exécuter cette commande SQL doit avoir les privilèges suivants définis au minimum ainsi :

Notez que l’exploitation d’un objet dans un schéma requiert également le privilège USAGE sur la base de données et le schéma parents.

Pour obtenir des instructions sur la création d’un rôle personnalisé avec un ensemble spécifique de privilèges, voir Création de rôles personnalisés.

Pour des informations générales sur les rôles et les privilèges accordés pour effectuer des actions SQL sur des objets sécurisables, voir Aperçu du contrôle d’accès.

Notes sur l’utilisation¶

• Si vous souhaitez mettre à jour une fonction de métrique des données existante et si vous avez besoin de voir la définition actuelle de la fonction, exécutez la commande DESCRIBE FUNCTION (DMF) ou appelez la fonction GET_DDL.

• Concernant les métadonnées :

  Attention

  Les clients doivent s’assurer qu’aucune donnée personnelle (autre que pour un objet utilisateur), donnée sensible, donnée à exportation contrôlée ou autre donnée réglementée n’est saisie comme métadonnée lors de l’utilisation du service Snowflake. Pour plus d’informations, voir Champs de métadonnées dans Snowflake.

Exemple¶

Faites de la DMF une DMF sûre :

ALTER FUNCTION governance.dmfs.count_positive_numbers(
 TABLE(
   NUMBER,
   NUMBER,
   NUMBER
))
SET SECURE;