ALTER APPLICATION SET CONFIGURATION DEFINITION¶

Syntaxe¶

Pour APPLICATION_NAME :

ALTER APPLICATION SET CONFIGURATION DEFINITION <config>
  TYPE = APPLICATION_NAME
  LABEL = '<label>'
  DESCRIPTION = '<description>'
  APPLICATION_ROLES = ( <app_role1> [ , <app_role2> ... ] );

Pour STRING :

ALTER APPLICATION SET CONFIGURATION DEFINITION <config>
  TYPE = STRING
  LABEL = '<label>'
  DESCRIPTION = '<description>'
  APPLICATION_ROLES = ( <app_role1> [ , <app_role2> ... ] )
  SENSITIVE = { TRUE | FALSE };

Pour SECRET_AUTHORIZATION :

ALTER APPLICATION SET CONFIGURATION DEFINITION <config>
  TYPE = SECRET_AUTHORIZATION
  SECRET = <schema>.<secret>
  LABEL = '<label>'
  DESCRIPTION = '<description>'
  APPLICATION_ROLES = ( <app_role1> [ , <app_role2> ... ] );

Paramètres¶

config

Identificateur pour la configuration de l’application.

TYPE

Spécifie le type de configuration de l’application. Valeurs prises en charge :

• APPLICATION_NAME

• STRING

• SECRET_AUTHORIZATION

SECRET = schema.secret

Spécifie le secret que le consommateur renseigne avec des jetons au cours du flux OAuth. Requis lorsque TYPE = SECRET_AUTHORIZATION. Le secret doit appartenir à l’application qui crée la configuration.

Le nom peut être spécifié en tant que schema.secret, auquel cas la propre base de données de l’application est implicite, ou en tant que database.schema.secret pleinement qualifié. Dans les deux cas, le secret doit appartenir à l’application.

Lors de la création de la configuration, le système vérifie que le secret s’est vu accorder MODIFY sur tous les rôles d’application spécifiés. Pour plus d’informations, voir Demander aux consommateurs une autorisation OAuth.

LABEL = 'label'

Spécifie une étiquette pour la configuration de l’application à afficher dans Snowsight.

DESCRIPTION = 'description'

Spécifie une description de la configuration de l’application. Snowflake recommande d’inclure des informations sur le type de configuration de l’application et la raison pour laquelle l’application l’exige.

APPLICATION_ROLES = ( <app_role1> [ , <app_role2> ... ] )

Spécifie les rôles d’application qui auront accès à l’objet de configuration de l’application.

SENSITIVE = { TRUE | FALSE }

Spécifie si la valeur de la configuration doit être traitée comme sensible. Lorsque définie sur TRUE, la valeur n’est pas affichée dans la sortie de SHOW CONFIGURATIONS ou DESCRIBE CONFIGURATION. Requis lorsque TYPE = STRING. Non valide pour les autres types de configurations. Spécifier SENSITIVE avec SECRET_AUTHORIZATION ou APPLICATION_NAME renvoie une erreur de compilation. Pour plus d’informations, voir Configurations sensibles.

Notes sur l’utilisation¶

• Cette commande ne peut être utilisée que par une Snowflake Native App.

• Lors de la création d’une définition de configuration pour le nom de l’application du serveur pour la communication inter-applications, vous devez définir les paramètres LABEL et DESCRIPTION sur les mêmes valeurs que les paramètres LABEL et DESCRIPTION de l’objet APPLICATION SPECIFICATION associé.