Referência de comando de Declarative Native App¶

Os comandos a seguir incluem novos parâmetros para oferecer suporte à criação e publicação de pacotes de aplicativo:

CREATE APPLICATION PACKAGE¶

O comando CREATE APPLICATION PACKAGE oferece suporte a um novo parâmetro opcional, TYPE = DATA, que especifica que o aplicativo será um 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.

ALTER APPLICATION PACKAGE¶

O comando ALTER APPLICATION PACKAGE oferece suporte aos seguintes novos parâmetros opcionais para ajudar na criação e publicação de Declarative Native Apps. Esses novos parâmetros não são suportados para Snowflake Native Apps.

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.

Nota

Se você fizer iterações nos arquivos após criar a versão ativa, precisará fazer as mesmas alterações nos arquivos na área de preparação para manter as versões futuras consistentes.

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;
```

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';

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;
```
Crie o pacote do aplicativo, mas não o confirme:
```
ALTER APPLICATION PACKAGE market_data_app BUILD;
```

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';

Lance o pacote do aplicativo no Snowflake Marketplace:
```
ALTER APPLICATION PACKAGE market_data_app RELEASE;
```

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';

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
```

GRANT IMPORTED PRIVILEGES ON APPLICATION¶

O comando GRANT IMPORTED PRIVILEGES oferece suporte a um novo parâmetro opcional, ON APPLICATION <name>.

Esse comando permite que os consumidores concedam acesso a todos os dados e exibições em um Declarative Native App a outros membros da organização.

Esse comando pode ser usado em qualquer Declarative Native App e não exige que as funções do aplicativo sejam definidas para o pacote.

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;