ALTER APPLICATION SET SPECIFICATIONS¶

Cria ou atualiza uma especificação de aplicativo para um Snowflake Native App.

Nota

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

Consulte também:: ALTER APPLICATION, ALTER APPLICATION … { APPROVE | DECLINE} SPECIFICATION, ALTER APPLICATION DROP SPECIFICATION

Sintaxe¶

Integração de acesso externo¶

ALTER APPLICATION SET SPECIFICATION <app_spec_name>
  TYPE = EXTERNAL_ACCESS
  LABEL = '<label>'
  DESCRIPTION = '<description>'
  { HOST_PORTS | PRIVATE_HOST_PORTS } = ( '<value>' [, '<value>', ... ] )

Copy

Integração de segurança (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>' ... ] );

Copy

Integração de segurança (AUTHORIZATION_CODE)¶

ALTER APPLICATION SET SPECIFICATION <app_spec_name>
  TYPE = SECURITY_INTEGRATION
  LABEL = '<string_literal>'
  DESCRIPTION = '<string_literal>'
  OAUTH_TYPE = 'AUTHORIZATION_CODE'
  OAUTH_TOKEN_ENDPOINT = '<string_literal>'
  [ OAUTH_AUTHORIZATION_ENDPOINT = '<string_literal>' ]
  [ OAUTH_ALLOWED_SCOPES = ( '<scope>' [ , '<scope>' ... ] ) ];

Copy

Integração de segurança (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>' ... ] ) ];

Copy

Listagem¶

ALTER APPLICATION SET SPECIFICATION <app_spec_name>
  TYPE = LISTING
  LABEL = '<string_literal>'
  DESCRIPTION = '<string_literal>'
  TARGET_ACCOUNTS = '<account_list>'
  LISTING = <listing_name>
  [ AUTO_FULFILLMENT_REFRESH_SCHEDULE = '<schedule>' ]

Copy

Parâmetros gerais¶

app_spec_name

Identificador da especificação de aplicativo.

TYPE = {EXTERNAL_ACCESS | SECURITY_INTEGRATION | LISTING}

Especifica o tipo de especificação de aplicativo. Os valores suportados são:

LABEL = 'label'

Especifica um rótulo para a especificação de aplicativo. Este rótulo é o nome da especificação de aplicativo que fica visível para o consumidor. Cada especificação de aplicativo deve ter um rótulo exclusivo.

DESCRIPTION = 'description'

Especifica uma descrição da especificação de aplicativo. O Snowflake recomenda incluir informações sobre o tipo de especificação de aplicativo e por que ela é exigida pelo aplicativo.

Parâmetros de integração de acesso externo¶

HOST_PORTS | PRIVATE_HOST_PORTS = ( 'value' [ , 'value', ... ] ): Especifica uma lista de portas de host ou portas de host privadas às quais o aplicativo pode se conectar. Essas portas são usadas por integrações de acesso externo.

Parâmetros de integração de segurança - CLIENT_CREDENTIALS¶

OAUTH_TYPE = 'CLIENT_CREDENTIALS': Especifica o tipo de integração de segurança para Autenticação de API externa. Consulte CREATE SECURITY INTEGRATION (Autenticação de API externa) para obter mais informações.
OAUTH_TOKEN_ENDPOINT = 'string_literal': Especifica o ponto de extremidade do token usado pelo cliente para obter um token de acesso apresentando sua concessão de autorização ou token de atualização. Consulte CREATE SECURITY INTEGRATION (Autenticação de API externa) para obter mais informações.
OAUTH_ALLOWED_SCOPES = ( 'scope' [ , 'scope' ... ] ): Especifica uma lista de escopos separada por vírgulas, com aspas simples em torno de cada escopo, a ser usada ao fazer uma solicitação do OAuth por uma função com USAGE na integração durante o fluxo de credenciais do cliente OAuth. Consulte CREATE SECURITY INTEGRATION (Autenticação de API externa) para obter mais informações.
OAUTH_ACCESS_TOKEN_VALIDITY = integer: Especifica a vida útil padrão do token de acesso OAuth (em segundos) emitido por um servidor OAuth. Consulte CREATE SECURITY INTEGRATION (Autenticação de API externa) para obter mais informações.

Parâmetros de integração de segurança - AUTHORIZATION_CODE¶

OAUTH_TYPE = 'AUTHORIZATION_CODE': Especifica o tipo de integração de segurança para Autenticação de API externa. Consulte CREATE SECURITY INTEGRATION (Autenticação de API externa) para obter mais informações.
OAUTH_TOKEN_ENDPOINT = 'string_literal': Especifica o ponto de extremidade do token usado pelo cliente para obter um token de acesso apresentando sua concessão de autorização ou token de atualização. Consulte CREATE SECURITY INTEGRATION (Autenticação de API externa) para obter mais informações.
OAUTH_AUTHORIZATION_ENDPOINT = 'string_literal': Especifica o URL para autenticação ao serviço externo. Consulte CREATE SECURITY INTEGRATION (Autenticação de API externa) para obter mais informações.
OAUTH_ACCESS_TOKEN_VALIDITY = integer: Especifica a vida útil padrão do token de acesso OAuth (em segundos) emitido por um servidor OAuth. Consulte CREATE SECURITY INTEGRATION (Autenticação de API externa) para obter mais informações.
OAUTH_REFRESH_TOKEN_VALIDITY = integer: Especifica a vida útil padrão do token de atualização OAuth (em segundos) emitido por um servidor OAuth. Consulte CREATE SECURITY INTEGRATION (Autenticação de API externa) para obter mais informações.

Parâmetros de integração de segurança - JWT_BEARER¶

OAUTH_TYPE = 'JWT_BEARER': Especifica o tipo de integração de segurança para Autenticação de API externa. Consulte CREATE SECURITY INTEGRATION (Autenticação de API externa) para obter mais informações.
OAUTH_TOKEN_ENDPOINT = 'string_literal': Especifica o ponto de extremidade do token usado pelo cliente para obter um token de acesso apresentando sua concessão de autorização ou token de atualização. Consulte CREATE SECURITY INTEGRATION (Autenticação de API externa) para obter mais informações.
OAUTH_AUTHORIZATION_ENDPOINT = 'string_literal': Especifica o URL para autenticação ao serviço externo. Consulte CREATE SECURITY INTEGRATION (Autenticação de API externa) para obter mais informações.
OAUTH_REFRESH_TOKEN_VALIDITY = integer: Especifica a vida útil padrão do token de atualização OAuth (em segundos) emitido por um servidor OAuth. Consulte CREATE SECURITY INTEGRATION (Autenticação de API externa) para obter mais informações.

Listing parameters¶

TARGET_ACCOUNTS = 'account_list'

Especifica uma cadeia de caracteres de contas de destino entre aspas simples, separada por vírgulas, sem espaços. Cada conta deve ser especificada no formato. OrgName.AccountName; por exemplo: 'ProviderOrg.ProviderAccount,PartnerOrg.PartnerAccount'. Quando a especificação é aprovada, as contas são adicionadas à listagem. Quando recusada, todas as contas são removidas da listagem.

LISTING = listing_name

Especifica o identificador da listagem externa criada pelo app. A listagem já deve existir e ter sido criada pelo app com um compartilhamento anexado. Depois que a listagem é definida em uma especificação do app, o nome da listagem não pode ser alterado.

AUTO_FULFILLMENT_REFRESH_SCHEDULE = 'schedule'

Opcional. Especifica o cronograma de atualização para compartilhamento de dados entre regiões. Esse parâmetro é necessário para compartilhar dados entre regiões. O valor pode ser especificado em dois formatos:

num MINUTE: Número de minutos, com um mínimo de 10 e um máximo de 11.520 minutos (oito dias).
USING CRON expression time_zone: Expressão cron com fuso horário para a atualização.

Notas de uso¶

Para usar este comando, os provedores devem garantir que o arquivo de manifesto do aplicativo use manifest_version = 2.

Exemplos¶

Criar uma especificação do app para acesso externo:

ALTER APPLICATION SET SPECIFICATION eai_spec
  TYPE = EXTERNAL_ACCESS
  LABEL = 'External API Access'
  DESCRIPTION = 'Connect to external weather API'
  HOST_PORTS = ('api.weather.com:443', 'api.openweather.org:443');

Copy

Criar uma especificação do app para uma integração de segurança OAuth:

ALTER APPLICATION SET SPECIFICATION oauth_spec
  TYPE = SECURITY_INTEGRATION
  LABEL = 'OAuth Integration'
  DESCRIPTION = 'Connect to Microsoft Graph API'
  OAUTH_TYPE = 'CLIENT_CREDENTIALS'
  OAUTH_TOKEN_ENDPOINT = 'https://login.microsoftonline.com/YOUR_TENANT_ID/oauth2/v2.0/token'
  OAUTH_ALLOWED_SCOPES = ('https://graph.microsoft.com/.default');

Copy

Criar uma especificação do app para compartilhamento de dados por meio de uma listagem:

ALTER APPLICATION SET SPECIFICATION shareback_spec
  TYPE = LISTING
  LABEL = 'Telemetry Data Sharing'
  DESCRIPTION = 'Share telemetry and usage data with provider'
  TARGET_ACCOUNTS = 'ProviderOrg.ProviderAccount,PartnerOrg.PartnerAccount'
  LISTING = telemetry_listing
  AUTO_FULFILLMENT_REFRESH_SCHEDULE = '720 MINUTE';

Copy