ALTER APPLICATION PACKAGE

Modifica as propriedades de um pacote de aplicativo existente no Native Apps Framework.

Consulte também:

CREATE APPLICATION PACKAGE, DROP APPLICATION PACKAGE, SHOW APPLICATION PACKAGES, SHOW VERSIONS, SHOW RELEASE DIRECTIVES

Sintaxe

ALTER APPLICATION PACKAGE [ IF EXISTS ] <name> SET
  [ DATA_RETENTION_TIME_IN_DAYS = <integer> ]
  [ MAX_DATA_EXTENSION_TIME_IN_DAYS = <integer> ]
  [ DEFAULT_DDL_COLLATION = '<collation_specification>' ]
  [ COMMENT = <string-literal> ]
  [ DISTRIBUTION = { INTERNAL | EXTERNAL } ]
  [ MULTIPLE_INSTANCES = TRUE ]

ALTER APPLICATION PACKAGE [ IF EXISTS ] <name> UNSET
  [ DATA_RETENTION_TIME_IN_DAYS ]
  [ MAX_DATA_EXTENSION_TIME_IN_DAYS ]
  [ DEFAULT_DDL_COLLATION ]
  [ COMMENT ]
  [ DISTRIBUTION ]

ALTER APPLICATION <name> SET TAG <tag_name> = '<tag_value>' [ , <tag_name> = '<tag_value>' ... ]

ALTER APPLICATION <name> UNSET TAG <tag_name> [ , <tag_name> ... ]
Copy

Parâmetros

name

Especifica o identificador do pacote do aplicativo a ser alterado. Se o identificador contiver espaços, caracteres especiais ou caracteres com letras maiúsculas e minúsculas, toda a cadeia de caracteres deve ser delimitada por aspas duplas. Os identificadores delimitados por aspas duplas também diferenciam letras maiúsculas de minúsculas.

SET ...

Especifica uma (ou mais) propriedades a serem definidas para o pacote do aplicativo (separadas por espaços em branco, vírgulas ou novas linhas):

DATA_RETENTION_TIME_IN_DAYS = num

Especifica o número de dias para os quais as ações de Time Travel (CLONE e UNDROP) podem ser executadas no banco de dados, bem como especifica o tempo padrão de retenção do Time Travel para todos os esquemas criados no banco de dados.

O valor que você pode especificar depende da edição do Snowflake que você está usando:

  • Standard Edition: 0 ou 1

  • Enterprise Edition (ou superior): 0 a 90

MAX_DATA_EXTENSION_TIME_IN_DAYS = integer

Parâmetro de objeto que especifica o número máximo de dias para os quais o Snowflake pode estender o período de retenção de dados das tabelas no banco de dados para evitar que os fluxos nas tabelas se tornem obsoletos.

Para uma descrição detalhada deste parâmetro, consulte MAX_DATA_EXTENSION_TIME_IN_DAYS.

DEFAULT_DDL_COLLATION = 'collation_specification'

Especifica uma especificação de agrupamento padrão para:

  • Qualquer nova coluna adicionada às tabelas existentes no banco de dados.

  • Todas as colunas em novas tabelas adicionadas ao banco de dados.

A definição do parâmetro não altera a especificação de agrupamento para qualquer coluna existente.

Para obter mais informações sobre o parâmetro, consulte DEFAULT_DDL_COLLATION.

DEFAULT_DDL_COLLATION = 'collation_specification'

Especifica uma especificação de agrupamento padrão para:

  • Qualquer nova coluna adicionada às tabelas existentes no banco de dados.

  • Todas as colunas em novas tabelas adicionadas ao banco de dados.

A definição do parâmetro não altera a especificação de agrupamento para qualquer coluna existente.

Para obter mais informações sobre o parâmetro, consulte DEFAULT_DDL_COLLATION.

COMMENT = 'string_literal'

Adiciona um comentário ou substitui um comentário existente para o banco de dados.

DISTRIBUTION = { INTERNAL | EXTERNAL }

Especifica o tipo de listagem que um provedor pode criar ao usar o pacote de aplicativos como o produto de dados de uma listagem.

  • INTERNAL indica que um provedor só pode criar uma listagem privada dentro da mesma organização onde o pacote de aplicativo foi criado. A verificação de segurança automatizada não é executada quando a propriedade DISTRIBUTION está definida como INTERNAL.

  • EXTERNAL indica que um provedor pode criar listagens fora da mesma organização onde o pacote de aplicativo foi criado.

Consulte Execução da verificação de segurança automatizada para obter informações sobre a configuração da propriedade DISTRIBUTION e a varredura de segurança automatizada.

Nota

A configuração do parâmetro DISTRIBUTION para EXTERNAL aciona uma revisão de segurança automatizada para cada versão ativa e patch definido no pacote do aplicativo.

As seguintes restrições se aplicam até que a revisão de segurança automatizada tenha um status de APPROVED:

  • Você não pode definir uma diretriz de versão para uma versão ou patch.

  • Você não pode publicar uma listagem para o pacote de aplicativo.

MULTIPLE_INSTANCES = TRUE

Permite que o consumidor instale várias instâncias de um aplicativo a partir do pacote de aplicativos. Essa propriedade não pode ser definida para pacotes de aplicativos inclusos em uma listagem de avaliação ou monetizada.

Quando várias instâncias são permitidas, os consumidores podem instalar um máximo de dez instâncias de um aplicativo em sua conta.

Cuidado

Após definir essa propriedade como verdadeira, ela não poderá ser definida como FALSE ou redefinida posteriormente.

UNSET ...

Especifica uma (ou mais) propriedades e/ou parâmetros a serem desmarcados para o pacote do aplicativo, o que os redefine para os padrões:

  • DATA_RETENTION_TIME_IN_DAYS

  • MAX_DATA_EXTENSION_TIME_IN_DAYS

  • EXTERNAL_VOLUME

  • CATALOG

  • DEFAULT_DDL_COLLATION

  • TAG tag_name [ , tag_name ... ]

  • COMMENT

Você pode redefinir várias propriedades/parâmetros com uma única instrução ALTER; no entanto, cada propriedade/parâmetro deve ser separado por uma vírgula. Ao redefinir uma propriedade/parâmetro, especificar somente o nome; especificar um valor para a propriedade retornará um erro.

Notas de uso

  • Se você não especificar os valores das propriedades opcionais, o comando usará os valores especificados no arquivo de manifesto do aplicativo.

    Se você especificar valores para as propriedades no comando e no arquivo de manifesto do aplicativo, os valores especificados no comando terão precedência.

  • Se duas versões estiverem ativas (por exemplo, se a versão atual não tiver sido concluída), a adição de uma nova versão resultará em erro.

  • Novas versões são adicionadas com um número de patch padrão de 0.

  • Em relação aos metadados:

    Atenção

    Os clientes devem garantir que nenhum dado pessoal (exceto para um objeto do usuário), dados sensíveis, dados controlados por exportação ou outros dados regulamentados sejam inseridos como metadados ao usar o serviço Snowflake. Para obter mais informações, consulte Campos de metadados no Snowflake.

Exemplos

ALTER APPLICATION PACKAGE hello_snowflake_package SET
  COMMENT = 'Altered the Hello Snowflake app.';
Copy
+-------------------------------------------+
| status                                    |
|-------------------------------------------|
| Statement executed successfully.          |
+-------------------------------------------+