snow app version create¶
Adiciona um novo patch à versão fornecida definida no pacote do seu aplicativo. Se a versão não existir, cria uma versão com patch 0.
Sintaxe¶
snow app version create
<version>
--patch <patch>
--label <label>
--skip-git-check
--from-stage
--interactive / --no-interactive
--force
--package-entity-id <package_entity_id>
--app-entity-id <app_entity_id>
--project <project_definition>
--env <env_overrides>
--connection <connection>
--host <host>
--port <port>
--account <account>
--user <user>
--password <password>
--authenticator <authenticator>
--private-key-file <private_key_file>
--token-file-path <token_file_path>
--database <database>
--schema <schema>
--role <role>
--warehouse <warehouse>
--temporary-connection
--mfa-passcode <mfa_passcode>
--enable-diag
--diag-log-path <diag_log_path>
--diag-allowlist-path <diag_allowlist_path>
--format <format>
--verbose
--debug
--silent
Argumentos¶
version
Versão a ser definida no seu pacote de aplicativo. Se a versão já existir, um patch autoincrementado será adicionado à versão. O padrão é a versão especificada no arquivo
manifest.yml
.
Opções¶
--patch INTEGER
O número do patch que você deseja criar para uma versão existente. O padrão é indefinido se não tiver sido definido, o que significa que Snowflake CLI usa o patch especificado no arquivo
manifest.yml
ou gera automaticamente um novo número de patch.--label TEXT
Um rótulo para a versão que é exibida aos consumidores. Se não for definido, será usado o rótulo da versão especificado no arquivo
manifest.yml
.--skip-git-check
Quando ativado, o Snowflake CLI ignora a verificação se seu projeto tem algum arquivo não rastreado ou em estágios no git. Padrão: não definido. Padrão: falso.
--from-stage
Quando ativado, o Snowflake CLI cria uma versão do estágio atual do pacote do aplicativo sem sincronizar com o estágio primeiro. Padrão: falso.
--interactive / --no-interactive
Quando ativada, esta opção exibe prompts mesmo que a entrada e a saída padrão não sejam dispositivos terminais. O padrão é True em um ambiente shell interativo e False caso contrário.
--force
Quando ativada, esta opção faz com que o comando aprove implicitamente quaisquer prompts que surjam. Você deve habilitar esta opção se o modo interativo não estiver especificado e se quiser executar ações potencialmente destrutivas. O padrão é não definido. Padrão: falso.
--package-entity-id TEXT
O ID da entidade do pacote no qual a operação é feita quando definition_version for 2 ou superior.
--app-entity-id TEXT
O ID da entidade do aplicativo no qual a operação é feita quando definition_version for 2 ou superior.
-p, --project TEXT
Caminho onde o projeto Snowflake está. O padrão é o diretório de trabalho atual.
--env TEXT
Cadeia de caracteres no formato chave=valor. Substitui variáveis da seção env usadas para modelos. Padrão: [].
--connection, -c, --environment TEXT
Nome da conexão, conforme definido no arquivo
config.toml
. Padrão:padrão
.--host TEXT
Endereço do host da conexão. Substitui o valor especificado para a conexão.
--port INTEGER
Porta para a conexão. Substitui o valor especificado para a conexão.
--account, --accountname TEXT
Nome atribuído à sua conta Snowflake. Substitui o valor especificado para a conexão.
--user, --username TEXT
Nome de usuário para se conectar ao Snowflake. Substitui o valor especificado para a conexão.
--password TEXT
Senha do Snowflake. Substitui o valor especificado para a conexão.
--authenticator TEXT
Autenticador Snowflake. Substitui o valor especificado para a conexão.
--private-key-file, --private-key-path TEXT
Caminho do arquivo de chave privada Snowflake. Substitui o valor especificado para a conexão.
--token-file-path TEXT
Caminho para o arquivo com um token OAuth que deve ser usado ao conectar-se ao Snowflake.
--database, --dbname TEXT
Banco de dados a ser usado. Substitui o valor especificado para a conexão.
--schema, --schemaname TEXT
Esquema de banco de dados a ser usado. Substitui o valor especificado para a conexão.
--role, --rolename TEXT
Função a ser usada. Substitui o valor especificado para a conexão.
--warehouse TEXT
Warehouse a ser usado. Substitui o valor especificado para a conexão.
--temporary-connection, -x
Usa conexão definida com parâmetros de linha de comando, em vez de uma definida na configuração. Padrão: falso.
--mfa-passcode TEXT
Token a ser usado para autenticação multifator (MFA).
--enable-diag
Execução do teste de diagnóstico do conector Python. Padrão: falso.
--diag-log-path TEXT
Caminho do relatório de diagnóstico. Padrão: <temporary_directory>.
--diag-allowlist-path TEXT
Caminho do relatório de diagnóstico para a lista de permissões opcional.
--format [TABLE|JSON]
Especifica o formato de saída. Padrão: TABLE.
--verbose, -v
Exibe entradas de log para os níveis de log
info
e superiores. Padrão: falso.--debug
Exibe entradas de log para níveis de log de
depuração
e superiores; os logs de depuração contêm informações adicionais. Padrão: falso.--silent
Desliga a saída intermediária para o console. Padrão: falso.
--help
Exibe o texto de ajuda para este comando.
Notas de uso¶
Nota
Este comando não aceita substituições de função ou warehouse para seu arquivo config.toml
. Adicione-os à definição do aplicativo nativo em snowflake.yml
ou snowflake.local.yml
em vez disso.
Este comando cria um pacote de aplicativo (se ele não existir) com uma versão e um patch opcional.
Se você não fornecer uma versão, o comando usará a versão especificada no arquivo
manifest.yml
. Se a versão não estiver presente no arquivomanifest.yml
, o comando gera um erro.Se você fornecer o argumento da versão e a opção
--patch
, e o pacote do aplicativo ainda não existir, o comando gerará um erro. Você deve fornecer apenas o argumento de versão para criar um novo pacote de aplicativo com a versão necessária.Se você fornecer o argumento da versão e a opção
--patch
, e a versão ainda não existir, o comando gerará um erro. Você deve fornecer apenas o argumento de versão para criar uma nova versão com um patch 0 predeterminado.Se você estiver trabalhando em um repositório Git e executar este comando, o comando verificará se há alterações locais na sua cópia de trabalho. Se encontrar alterações locais, ele solicitará que você confirme se é seguro prosseguir. Você pode pular esta verificação usando a opção
--skip-git-check
.Se o pacote do aplicativo não existir, um novo será criado pelo Snowflake CLI e é marcado com um comentário especial
GENERATED_BY_SNOWCLI
. Também executa quaisquer ganchos pós-implantação e carrega arquivos de código para o estágio.Se o pacote do aplicativo já existir e sua propriedade de distribuição for
INTERNAL
, o comando verificará se o pacote foi criado pelo Snowflake CLI. Caso contrário, o comando gerará um erro. Se a distribuição do pacote de aplicativo forEXTERNAL
, nenhuma verificação desse tipo será realizada.O comando avisa se o pacote de aplicativo com o qual você está trabalhando tem um valor diferente para distribuição do que o definido na definição do projeto resolvido, mas continua a execução.
Se a versão for referenciada em uma diretiva de lançamento para o pacote do aplicativo, o comando solicitará que você confirme se deseja criar um patch nesta versão.
Se a versão já existir e você não fornecer uma opção
--patch
, o Native Apps Framework incrementa automaticamente o número do patch para esta versão existente. Caso contrário, ele cria um patch personalizado na versão fornecida por você.A opção
--label
define um rótulo para a versão ou o patch criado com esse comando. Se especificado, esse valor substitui o rótulo especificado para aversão
:codenowrap: definida no arquivomanifest.yml
do aplicativo.Se você especificar uma versão nomeada, como
snow app version create my_version
, o campoversão
no arquivomanifest.yml
será ignorado.
Exemplos¶
Esses exemplos pressupõem que você fez as alterações necessárias em seus arquivos de código e os adicionou aos seus arquivos snowflake.yml
ou snowflake.local.yml
.
Se você quiser criar um pacote de aplicativo e adicionar uma versão V1 a ele, use o seguinte comando:
snow app version create V1 --connection="dev"
Você também pode usar o comando acima para criar uma versão V1 em um pacote de aplicativo existente.
Se você quiser adicionar um patch à versão V1 usando a funcionalidade de incremento automático e invocar o modo interativo, use o seguinte comando:
snow app version create V1 --interactive --connection="dev"
Se quiser adicionar um número de patch personalizado à versão V1
e ignorar o modo interativo, mesmo se estiver em um shell interativo, use o seguinte comando:
snow app version create V1 --patch 42 --force --connection="dev"
Para criar uma nova versão a partir do conteúdo atual do estágio sem sincronizar os arquivos com o estágio primeiro, use o seguinte comando:
snow app version create V1 --from-stage --connection="dev"