ALTER APPLICATION SET CONFIGURATION DEFINITION¶

Syntax¶

APPLICATION_NAME:

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

STRING:

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

SECRET_AUTHORIZATION:

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

Parameter¶

config

Bezeichner für die App-Konfiguration.

TYPE

Gibt den Typ der App-Konfiguration an. Folgende Werte werden unterstützt:

• APPLICATION_NAME

• STRING

• SECRET_AUTHORIZATION

SECRET = schema.secret

Gibt das Geheimnis an, das der Verbraucher während des OAuth-Ablaufs mit Token auffüllt. Erforderlich, wenn TYPE = SECRET_AUTHORIZATION. Das Geheimnis muss der Anwendung gehören, die die Konfiguration erstellt.

Der Name kann als schema.secret angegeben werden (in diesem Fall ist die eigene Datenbank der App impliziert) oder als vollqualifizierter database.schema.secret. In beiden Formen muss das Geheimnis der App gehören.

Beim Erstellen der Konfiguration überprüft das System, ob das Geheimnis die MODIFY-Berechtigung für alle angegebenen Anwendungsrollen hat. Weitere Informationen dazu finden Sie unter Request OAuth authorization from consumers.

LABEL = 'label'

Gibt eine Bezeichnung für die App-Konfiguration an, die in der Snowsight angezeigt werden soll.

DESCRIPTION = 'description'

Gibt eine Beschreibung der Konfiguration der App an. Snowflake empfiehlt, Informationen über den Typ der App-Spezifikation anzugeben, und warum dieser von der App benötigt wird.

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

Gibt die Anwendungsrollen an, die Zugriff auf das App-Konfigurationsobjekt haben.

SENSITIVE = { TRUE | FALSE }

Gibt an, ob der Konfigurationswert als sensibel behandelt werden soll. Ist dies auf TRUE gesetzt, wird der Wert in der Ausgabe von SHOW CONFIGURATIONS oder DESCRIBE CONFIGURATION nicht angezeigt. Erforderlich, wenn TYPE = STRING. Nicht gültig für andere Konfigurationstypen. Angabe von SENSITIVE durch SECRET_AUTHORIZATION oder APPLICATION_NAME gibt einen Kompilierungsfehler zurück. Weitere Informationen dazu finden Sie unter Sensible Konfigurationen.

Nutzungshinweise¶

• Dieser Befehl kann nur von einer Snowflake Native App verwendet werden:

• Wenn Sie eine Konfigurationsdefinition für den Namen der Serveranwendung für die Kommunikation zwischen Anwendungen erstellen, müssen Sie die Parameter LABEL und DESCRIPTION auf dieselben Werte wie die Parameter LABEL und DESCRIPTION des zugehörigen APPLICATION SPECIFICATION-Objekts festlegen.