ALTER APPLICATION SET SPECIFICATIONS¶
为 Snowflake Native App 创建或更新一个 应用程序规范。
备注
此命令只能由一个 Snowflake Native App 使用。
- 另请参阅:
ALTER APPLICATION、ALTER APPLICATION ... { APPROVE | DECLINE} SPECIFICATION、ALTER APPLICATION DROP SPECIFICATION
语法¶
外部访问集成¶
ALTER APPLICATION SET SPECIFICATION <app_spec_name>
TYPE = EXTERNAL_ACCESS
LABEL = '<label>'
DESCRIPTION = '<description>'
{ HOST_PORTS | PRIVATE_HOST_PORTS } = ( '<value>' [, '<value>', ... ] )
安全集成 (CLIENT_CREDENTIALS)¶
ALTER APPLICATION SET SPECIFICATION <app_spec_name>
TYPE = SECURITY_INTEGRATION
LABEL = '<string_literal>'
DESCRIPTION = '<string_literal>'
OAUTH_TYPE = 'CLIENT_CREDENTIALS'
OAUTH_TOKEN_ENDPOINT = '<string_literal>'
OAUTH_ALLOWED_SCOPES = ( '<scope>' [ , '<scope>' ... ] );
安全集成 (JWT_BEARER)¶
ALTER APPLICATION SET SPECIFICATION <app_spec_name>
TYPE = SECURITY_INTEGRATION
LABEL = '<string_literal>'
DESCRIPTION = '<string_literal>'
OAUTH_TYPE = 'JWT_BEARER'
OAUTH_TOKEN_ENDPOINT = '<string_literal>'
[ OAUTH_AUTHORIZATION_ENDPOINT = '<string_literal>' ]
[ OAUTH_ALLOWED_SCOPES = ( '<scope>' [ , '<scope>' ... ] ) ];
一般参数¶
app_spec_name
应用程序规范 的标识符。
TYPE = {EXTERNAL_ACCESS | SECURITY_INTEGRATION}
指定应用程序规范的类型。支持的值包括:
LABEL = 'label'
为应用程序规范指定标签。此标签是使用者可以看到的应用程序规范的名称。每个应用程序规范都必须有唯一的标签。
DESCRIPTION = 'description'
指定应用程序规范的描述。Snowflake 建议提供有关应用程序规范类型以及应用程序为什么需要它的信息。
外部访问集成参数¶
HOST_PORTS | PRIVATE_HOST_PORTS = ( 'value' [ , 'value', ... ] )
指定应用程序可以连接的主机端口或私有主机端口的列表。这些端口由外部访问集成使用。
安全集成参数 - CLIENT_CREDENTIALS¶
OAUTH_TYPE = 'CLIENT_CREDENTIALS'
指定用于外部 API 身份验证的安全集成类型。有关更多信息,请参阅 CREATE SECURITY INTEGRATION(外部 API 身份验证)。
OAUTH_TOKEN_ENDPOINT = 'string_literal'
指定客户端用于获取访问令牌的令牌端点,方法是提供其授权授予或刷新令牌。有关更多信息,请参阅 CREATE SECURITY INTEGRATION(外部 API 身份验证)。
OAUTH_ALLOWED_SCOPES = ( 'scope' [ , 'scope' ... ] )
指定以逗号分隔的范围列表,每个范围放在单引号内,在 OAuth 客户端凭证流期间由集成中具备 USAGE 的角色通过 OAuth 发出请求时使用。有关更多信息,请参阅 CREATE SECURITY INTEGRATION(外部 API 身份验证)。
OAUTH_ACCESS_TOKEN_VALIDITY = integer
指定由 OAuth 服务器颁发的 OAuth 访问令牌的默认生命周期(以秒为单位)。有关更多信息,请参阅 CREATE SECURITY INTEGRATION(外部 API 身份验证)。
安全集成参数 - JWT_BEARER¶
OAUTH_TYPE = 'JWT_BEARER'
指定用于外部 API 身份验证的安全集成类型。有关更多信息,请参阅 CREATE SECURITY INTEGRATION(外部 API 身份验证)。
OAUTH_TOKEN_ENDPOINT = 'string_literal'
指定客户端用于获取访问令牌的令牌端点,方法是提供其授权授予或刷新令牌。有关更多信息,请参阅 CREATE SECURITY INTEGRATION(外部 API 身份验证)。
OAUTH_AUTHORIZATION_ENDPOINT = 'string_literal'
指定用于对外部服务进行身份验证的 URL。有关更多信息,请参阅 CREATE SECURITY INTEGRATION(外部 API 身份验证)。
OAUTH_REFRESH_TOKEN_VALIDITY = integer
指定由 OAuth 服务器颁发的 OAuth 刷新令牌的默认生命周期(以秒为单位)。有关更多信息,请参阅 CREATE SECURITY INTEGRATION(外部 API 身份验证)。
使用说明¶
要使用此命令,提供商必须确保应用程序的清单文件使用的是
manifest_version = 2
。