Referência de comando de Declarative Native App¶

Sintaxe¶

CREATE APPLICATION PACKAGE [ IF NOT EXISTS ] <name> TYPE = DATA

Novo parâmetro opcional:

TYPE = [ DATA | NATIVE ]

Especifica o tipo de pacote de aplicativo a ser criado:

• DATA: indica que o pacote do aplicativo terá um Declarative Native App.

• NATIVE: indica que o pacote do aplicativo terá um Snowflake Native App. Este é o valor padrão.

Depois de especificar um tipo de pacote de aplicativo, você não poderá usar ALTER APPLICATION PACKAGE para mudar o tipo depois.

Quando TYPE = DATA é especificado, os outros parâmetros no comando, como DATA_RETENTION_TIME_IN_DAYS e COMMENT, não são suportados.

Este parâmetro requer uma função com os privilégios CREATE APPLICATION PACKAGE e CREATE DATABASE :ref:` <label-access_control_overview_privileges>`.

O criador do pacote de aplicativo recebe o privilégio OWNERSHIP automaticamente.

Sintaxe¶

ALTER APPLICATION PACKAGE <name>
[ ADD LIVE VERSION
| ADD VERSION FROM @STAGE/path
| BUILD
| COMMIT
| RELEASE [LIVE VERSION]
| ABORT LIVE VERSION ]
[COMMENT = 'string_literal']

Novos parâmetros opcionais¶

ADD LIVE VERSION

Crie uma versão ativa do pacote do aplicativo que possa ser editada. Essa versão ativa é usada para adicionar ou atualizar arquivos, como o arquivo de manifesto e os arquivos do notebook.

ADD VERSION FROM @<STAGE>/<path>

Cria uma versão ativa do pacote de aplicativo com base em arquivos de uma área de preparação. Esse método é útil se você tiver um conjunto de arquivos que deseja incluir no pacote do aplicativo e quiser adicioná-los todos de uma vez.

BUILD

Cria o aplicativo, mas não o confirma. Use esse comando para validar o arquivo de manifesto e continuar trabalhando no pacote do aplicativo.

COMMIT

Cria o aplicativo, confirma-o para publicação, mas não o lança.

O processo de confirmação prepara o pacote do aplicativo para publicação adicionando um número de versão interno e torna o pacote do aplicativo imutável.

RELEASE

Lança uma versão confirmada do aplicativo no Snowflake Marketplace.

RELEASE LIVE VERSION

Cria o aplicativo, confirma-o para publicação e o libera para o Snowflake Marketplace.

Equivalente a executar os comandos BUILD, COMMITe RELEASE em sequência.

ABORT LIVE VERSION

Remove a versão LIVE do pacote do aplicativo. Restaura o pacote do aplicativo para a última versão confirmada.

Parâmetros atuais¶

Esses parâmetros são compatíveis com Declarative Native Apps e Snowflake Native Apps.

<name>

Especifica o identificador do pacote do aplicativo.

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.

COMMENT = 'string_literal'

Opcional: Adiciona um comentário ou substitui um comentário atual para versão do aplicativo. Esse comentário é mostrado em SHOW APPLICATION PACKAGES.

Requisitos de controle de acesso¶

Esse comando requer uma função com o privilégio OWNERSHIP para o pacote do aplicativo.

Exemplos¶

• Crie um novo pacote de aplicativo:

  CREATE APPLICATION PACKAGE market_data_app TYPE = DATA;
  

  Copy

• Crie uma versão ativa do pacote do aplicativo que possa ser editada:

  ALTER APPLICATION PACKAGE market_data_app
    ADD LIVE VERSION
    COMMENT = 'Market views for Northern region';
  

  Copy

• Crie uma nova versão do pacote de aplicativo a partir de um pacote de aplicativo existente já preparado:

  ALTER APPLICATION PACKAGE market_data_app
    ADD VERSION FROM @my_stage/market_data_app_v1;
  

  Copy

• Crie o pacote do aplicativo, mas não o confirme:

  ALTER APPLICATION PACKAGE market_data_app BUILD;
  

  Copy

• Crie e confirme o pacote de aplicativo para publicação, mas sem lançá-lo:

  ALTER APPLICATION PACKAGE market_data_app
    COMMIT
    COMMENT = 'Market views for North and East regions';
  

  Copy

• Lance o pacote do aplicativo no Snowflake Marketplace:

  ALTER APPLICATION PACKAGE market_data_app RELEASE;
  

  Copy

• Crie, confirme e lance a versão ativa do pacote do aplicativo no Snowflake Marketplace:

  ALTER APPLICATION PACKAGE market_data_app RELEASE LIVE VERSION
    COMMENT = 'Market views for North, East, and West regions';
  

  Copy

• Depois de adicionar e editar uma versão ativa do aplicativo, pare de editar e restaure para a última versão confirmada:

  ALTER APPLICATION PACKAGE market_data_app ABORT LIVE VERSION
  

  Copy

Requisitos de controle de acesso¶

Esse comando requer uma função com o privilégio OWNER para o aplicativo instalado.

Sintaxe¶

GRANT IMPORTED PRIVILEGES ON APPLICATION <name> TO ROLE <role_name>;

Exemplo¶

GRANT IMPORTED PRIVILEGES ON APPLICATION market_data_app TO ROLE marketing_team_east;