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
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;
Publiez le profil de l’organisation MYORGPROFILE :
ALTER ORGANIZATION PROFILE MYORGPROFILE PUBLISH;