snow app version create¶

Sintaxe¶

snow app version create
  <version>
  --patch <patch>
  --skip-git-check
  --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.

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

--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 níveis de log info e superior. 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¶

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 arquivo manifest.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 for EXTERNAL, 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ê.

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"