ALTER APPLICATION SET CONFIGURATION DEFINITION¶

Sintaxe¶

Para APPLICATION_NAME:

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

Para STRING:

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

Para SECRET_AUTHORIZATION:

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

Parâmetros¶

config

Identificador para a configuração do app.

TYPE

Especifica o tipo de configuração do app. Os valores suportados são:

• APPLICATION_NAME

• STRING

• SECRET_AUTHORIZATION

SECRET = schema.secret

Especifica o segredo que o consumidor preenche com tokens durante o fluxo do OAuth. Obrigatório quando TYPE = SECRET_AUTHORIZATION. O segredo deve ser de propriedade do aplicativo que cria a configuração.

O nome pode ser especificado como schema.secret, caso em que o próprio banco de dados do app está implícito, ou como database.schema.secret totalmente qualificado. De qualquer forma, o segredo deve ser de propriedade do app.

Na criação da configuração, o sistema valida que o segredo recebeu MODIFY para todas as funções de aplicativo especificadas. Para obter mais informações, consulte Request OAuth authorization from consumers.

LABEL = 'label'

Especifica um rótulo para a configuração do app a ser exibida no Snowsight.

DESCRIPTION = 'description'

Especifica uma descrição da configuração do app. A Snowflake recomenda incluir informações sobre o tipo de configuração do app e por que ela é exigida pelo app.

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

Especifica as funções do aplicativo que terão acesso ao objeto de configuração do app.

SENSITIVE = { TRUE | FALSE }

especifica se o valor da configuração deve ser tratado como confidencial. Quando definido como TRUE, o valor não é exibido na saída de SHOW CONFIGURATIONS ou DESCRIBE CONFIGURATION. Obrigatório quando TYPE = STRING. Não é válido para outros tipos de configuração. Especificar SENSITIVE com SECRET_AUTHORIZATION ou APPLICATION_NAME retorna um erro de compilação. Para obter mais informações, consulte Configurações confidenciais.

Notas de uso¶

• Este comando só pode ser usado por um Snowflake Native App.

• Ao criar uma definição de configuração para o nome do app de servidor para comunicação entre apps, você deve definir os parâmetros LABEL e DESCRIPTION com os mesmos valores dos parâmetros LABEL e DESCRIPTION do objeto APPLICATION SPECIFICATION associado.