ALTER ORGANIZATION PROFILE

Modifie les propriétés d’un profil d’organisation.

Voir aussi :

CREATE ORGANIZATION PROFILE, DESCRIBE AVAILABLE ORGANIZATION PROFILE, DESCRIBE ORGANIZATION PROFILE, DROP ORGANIZATION PROFILE, SHOW AVAILABLE ORGANIZATION PROFILES, SHOW ORGANIZATION PROFILES, SHOW VERSIONS IN ORGANIZATION PROFILE

Syntaxe

ALTER ORGANIZATION PROFILE [ IF EXISTS ] <name> RENAME TO <new_name>

ALTER ORGANIZATION PROFILE [ IF EXISTS ] <name> PUBLISH

ALTER ORGANIZATION PROFILE <name> ADD VERSION [ [ IF NOT EXISTS ] <version_alias_name> ]
  FROM @<yaml_manifest_stage_location>

ALTER ORGANIZATION PROFILE <name> ADD LIVE VERSION [ [ IF NOT EXISTS ] <version_alias_name> ]
  FROM LAST

ALTER ORGANIZATION PROFILE <name> COMMIT

ALTER ORGANIZATION PROFILE <name> ABORT
Copy

Paramètres

name

Spécifie l’identificateur (nom) du profil d’organisation en cours de modification. Les noms des profils d’organisation ne peuvent contenir que des caractères majuscules ou des chiffres, et ils doivent commencer par une majuscule.

RENAME TO new_name

Modifie le nom du profil de l’organisation en new_name. Le nouvel identificateur doit être unique au sein de l’organisation actuelle. L’identificateur doit être conforme aux exigences de l’identificateur Snowflake. Voir Exigences relatives à l’identificateur. En outre, les noms des profils d’organisation ne peuvent contenir que des caractères majuscules ou des chiffres, et ils doivent commencer par un caractère majuscule.

Note

Un profil d’organisation portant le même nom ne peut pas déjà exister dans l’organisation ; dans le cas contraire, l’instruction renvoie une erreur.

PUBLISH

Permet de découvrir un profil d’organisation qui n’avait pas été découvert auparavant.

ADD VERSION [ [ IF NOT EXISTS ] version_alias_name ]

Spécifie l’identificateur unique de la version en cours d’ajout. Si version_alias_name n’est pas spécifié, aucun alias n’est créé. Si l’identificateur contient des espaces, des caractères spéciaux ou des caractères majuscules et minuscules, tout l’identificateur doit être délimité par des guillemets doubles. Les identificateurs entre guillemets doubles sont également sensibles à la casse. Les mots-clés FIRST, LAST, DEFAULT et LIVE sont réservés comme raccourcis de version et ne peuvent pas être utilisés. L’identificateur de version unique ne peut pas commencer par « version$ » et ne peut pas contenir de barre oblique ( / ). Pour des informations sur la syntaxe des identificateurs, voir Exigences relatives à l’identificateur.

ADD LIVE VERSION [ [ IF NOT EXISTS ] version_alias_name ]

Ajoute une nouvelle version modifiable en direct avec le nom spécifié à partir de la dernière version validée. version_alias_name est facultatif et s’il n’est pas spécifié, un alias n’est pas créé. Si l’identificateur contient des espaces, des caractères spéciaux ou des caractères majuscules et minuscules, tout l’identificateur doit être délimité par des guillemets doubles. Les identificateurs entre guillemets doubles sont également sensibles à la casse. Les mots-clés FIRST, LAST, DEFAULT et LIVE sont réservés comme raccourcis de version et ne peuvent pas être utilisés. L’identificateur de version unique ne peut pas commencer par « version$ » et ne peut pas contenir de barre oblique ( / ). Pour des informations sur la syntaxe des identificateurs, voir Exigences relatives à l’identificateur.

Les modifications apportées aux fichiers dans une version en direct ne sont pas appliquées au profil de l’organisation tant que la version en direct n’est pas validée. Les propriétés d’un profil d’organisation restent inchangées jusqu’à ce que la version live soit validée.

FROM 'yaml_manifest_stage_location'

Spécifie l’emplacement de la zone de préparation externe, de la zone de préparation interne ou de la zone de préparation manifeste du clone du référentiel Git de Snowflake au format YAML.

COMMIT

Valide les modifications dans le profil de l’organisation. La version live en cours de validation doit contenir un fichier manifeste de profil d’organisation valide.

ABORT

Annule les modifications apportées au profil de l’organisation.

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

Un rôle utilisé pour exécuter cette opération doit au minimum disposer des privilèges suivants :

Privilège

Objet

Remarques

OWNERSHIP ou MODIFY

Profil de l’organisation

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

  • Les profils d’organisation ne peuvent être renommés que lorsqu’ils sont à l’état de projet.

  • Lorsque vous paramétrez la version live du manifeste au format YAML pour un profil d’organisation, vous devez utiliser COMMIT pour appliquer les modifications ou ABORT pour les annuler. Un profil d’organisation ne peut avoir qu’une seule version en ligne à la fois.

Exemples

Modifiez le profil de l’organisation MYORGPROFILE pour utiliser un fichier manifeste mis à jour :

ALTER ORGANIZATION PROFILE MYORGPROFILE ADD VERSION V2 FROM @STAGE_PATH_WITH_UPDATED_MANIFEST;
Copy

Publiez le profil de l’organisation MYORGPROFILE :

ALTER ORGANIZATION PROFILE MYORGPROFILE PUBLISH;
Copy