ALTER SECRET¶

Syntaxe¶

OAuth avec flux d’identifiants de connexion client :

ALTER SECRET [ IF EXISTS ] <name> SET [ OAUTH_SCOPES = ( '<scope_1>' [ , '<scope_2>' ... ] ) ]
                                      [ COMMENT = '<string_literal>' ]

ALTER SECRET [ IF EXISTS ] <name> UNSET COMMENT

OAuth avec flux d’accord de code d’autorisation :

ALTER SECRET [ IF EXISTS ] <name> SET [ OAUTH_REFRESH_TOKEN = '<token>' ]
                                      [ OAUTH_REFRESH_TOKEN_EXPIRY_TIME = '<string_literal>' ]
                                      [ COMMENT = '<string_literal>' ]

ALTER SECRET [ IF EXISTS ] <name> UNSET COMMENT

Fournisseur Cloud :

ALTER SECRET [ IF EXISTS ] <name> SET [ API_AUTHENTICATION = '<cloud_provider_security_integration>' ]
                                      [ COMMENT = '<string_literal>' ]

ALTER SECRET [ IF EXISTS ] <name> UNSET COMMENT

Authentification de base :

ALTER SECRET [ IF EXISTS ] <name> SET [ USERNAME = '<username>' ]
                                      [ PASSWORD = '<password>' ]
                                      [ COMMENT = '<string_literal>' ]

ALTER SECRET [ IF EXISTS ] <name> UNSET COMMENT

Chaîne générique :

ALTER SECRET [ IF EXISTS ] <name> SET [ SECRET_STRING = '<string_literal>' ]
                                      [ COMMENT = '<string_literal>' ]

ALTER SECRET [ IF EXISTS ] <name> UNSET COMMENT

OAuth avec les paramètres de flux d’identifiants de connexion du client¶

name

Chaîne spécifiant l’identificateur (c’est-à-dire le nom) du secret ; elle doit être unique dans votre schéma.

SET ...

Spécifie un (ou plusieurs) paramètre(s) à définir (séparés par des espaces, des virgules ou de nouvelles lignes).

OAUTH_SCOPES = ( 'scope_1' [ , 'scope_2' ... ] )

Spécifie une liste des champs d’application séparés par des virgules à utiliser lors d’une requête à partir du serveur OAuth par un rôle avec USAGE sur l’intégration pendant le flux d””identifiants de connexion client OAuth.

Cette liste doit être un sous-ensemble des champs d’application définis dans la propriété OAUTH_ALLOWED_SCOPES de l’intégration de sécurité. Si les valeurs de propriété OAUTH_SCOPES ne sont pas spécifiées, le secret hérite de tous les champs d’application spécifiés dans l’intégration de sécurité.

Paramètres requis AWS IAM¶

SET ...

Spécifie un (ou plusieurs) paramètre(s) à définir (séparés par des espaces, des virgules ou de nouvelles lignes).

TYPE = CLOUD_PROVIDER_TOKEN

Spécifie qu’il s’agit d’un secret à utiliser avec un fournisseur de cloud, tel qu’Amazon Web Services (AWS).

API_AUTHENTICATION = 'cloud_provider_security_integration'

Spécifie la valeur name de l’intégration de sécurité Snowflake qui connecte Snowflake à un fournisseur cloud.

OAuth avec les paramètres de flux d’accord de code d’autorisation¶

name

Chaîne spécifiant l’identificateur (c’est-à-dire le nom) du secret ; elle doit être unique dans votre schéma.

SET ...

Spécifie un (ou plusieurs) paramètre(s) à définir (séparés par des espaces, des virgules ou de nouvelles lignes).

OAUTH_REFRESH_TOKEN = 'token'

Spécifie le jeton sous la forme d’une chaîne utilisée pour obtenir un nouveau jeton d’accès du serveur d’autorisation OAuth lorsque le jeton d’accès expire.

OAUTH_REFRESH_TOKEN_EXPIRY_TIME = 'string_literal'

Spécifie l’horodatage sous forme de chaîne lorsque le jeton d’actualisation OAuth expire.

Paramètres d’authentification de base¶

name

Chaîne spécifiant l’identificateur (c’est-à-dire le nom) du secret ; elle doit être unique dans votre schéma.

SET ...

Spécifie un (ou plusieurs) paramètre(s) à définir pour la session (séparés par des espaces, des virgules ou de nouvelles lignes).

USERNAME = 'username'

Spécifie la valeur du nom d’utilisateur à stocker dans le secret.

Spécifiez cette valeur de propriété lorsque vous utilisez un secret pour l’authentification de base (c’est-à-dire que le secret est TYPE = PASSWORD).

PASSWORD = 'password'

Spécifie la valeur du mot de passe à stocker dans le secret.

Spécifiez cette valeur de propriété lorsque vous utilisez un secret pour l’authentification de base (c’est-à-dire que le secret est TYPE = PASSWORD).

Paramètres de chaîne génériques¶

name

Chaîne spécifiant l’identificateur (c’est-à-dire le nom) du secret ; elle doit être unique dans votre schéma.

SET ...

Spécifie un (ou plusieurs) paramètre(s) à définir (séparés par des espaces, des virgules ou de nouvelles lignes).

SECRET_STRING = 'string_literal'

Spécifie la chaîne à stocker dans le secret.

La chaîne peut être un jeton API ou une chaîne de valeur sensible qui peut être utilisée dans le code du gestionnaire d’une UDF ou d’une procédure stockée. Pour plus de détails, voir Création et utilisation d’une intégration d’accès externe.

Vous ne devez pas utiliser cette propriété pour stocker un quelconque type de jeton OAuth ; utilisez l’un des autres types de secrets pour vos cas d’utilisation OAuth.

Paramètres communs : toutes les syntaxes¶

SET ...

Spécifie un (ou plusieurs) paramètre(s) à définir pour la session (séparés par des espaces, des virgules ou de nouvelles lignes).

COMMENT = 'string_literal'

Chaîne (littéral) qui spécifie un commentaire pour le secret.

Par défaut : aucune valeur

UNSET ...

Spécifie un(e) ou plusieurs paramètres/propriété(s) à désactiver pour le secret, ce qui les réinitialise à leurs valeurs par défaut :

• COMMENT

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 :

Le privilège USAGE relatif à la base de données et au schéma parents est exigé pour effectuer des opérations sur tout objet d’un schéma.

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¶

Concernant les métadonnées :

Exemples¶

Modifier le commentaire d’un secret :

ALTER SECRET service_now_creds_pw SET COMMENT = 'production secret for servicenow';

Copy