ALTER APPLICATION SET CONFIGURATION DEFINITION¶

構文¶

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> ... ] );

パラメーター¶

config

アプリ構成の識別子。

TYPE

アプリ構成の型を指定します。サポートされる値は次のとおりです。

• APPLICATION_NAME

• STRING

• SECRET_AUTHORIZATION

SECRET = schema.secret

OAuth フロー中にコンシューマーがトークンを格納するシークレットを指定します。:samp:`TYPE = SECRET_AUTHORIZATION`の場合に指定が必須となります。シークレットは、構成を作成するアプリケーションが所有している必要があります。

名前は schema.secret のように指定できます。この場合、アプリ自体のデータベースが暗黙的に使用されます。または完全修飾 database.schema.secret と指定することもできます。どちらの形式でも、シークレットはアプリが所有している必要があります。

構成の作成時に、システムは指定されたすべてのアプリケーションロールに対して、シークレットに MODIFY が付与されていることを検証します。詳細については、 コンシューマーからの OAuth 認証リクエスト をご参照ください。

LABEL = 'label'

Snowsight に表示するアプリ仕様のラベルを指定します。

DESCRIPTION = 'description'

アプリ構成の説明を指定します。Snowflakeでは、アプリの仕様タイプと、アプリ仕様がアプリに必要な理由について情報を含めることを推奨しています。

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

アプリ構成オブジェクトにアクセスできるアプリケーションロールを指定します。

SENSITIVE = { TRUE | FALSE }

構成値を機密として扱うかどうかを指定します。TRUE に設定した場合、その値は SHOW CONFIGURATIONS または DESCRIBE CONFIGURATION の出力に表示されません。TYPE = STRING`の場合に指定が必須となります。他の構成タイプでは有効ではありません。:code:`SENSITIVE を SECRET_AUTHORIZATION または APPLICATION_NAME とともに指定すると、コンパイルエラーを返します。詳細については、 機密性の高い構成 をご参照ください。

使用上の注意¶

• このコマンドは|native-app| でのみ使用できます。

• アプリ間通信用のサーバーアプリ名の構成定義を作成するときは、 LABEL および DESCRIPTION パラメーターを関連付けられた APPLICATION SPECIFICATION オブジェクトの LABEL および DESCRIPTION パラメーターと同じ値に設定する必要があります。