snow app version create¶

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>
  --workload-identity-provider <workload_identity_provider>
  --private-key-file <private_key_file>
  --token <token>
  --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>
  --oauth-client-id <oauth_client_id>
  --oauth-client-secret <oauth_client_secret>
  --oauth-authorization-url <oauth_authorization_url>
  --oauth-token-request-url <oauth_token_request_url>
  --oauth-redirect-uri <oauth_redirect_uri>
  --oauth-scope <oauth_scope>
  --oauth-disable-pkce
  --oauth-enable-refresh-tokens
  --oauth-enable-single-use-refresh-tokens
  --client-store-temporary-credential
  --format <format>
  --verbose
  --debug
  --silent
  --enhanced-exit-codes

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á armazenado. O padrão é o diretório de trabalho atual.

--env TEXT

Cadeia de caracteres no formato key=value. Substitui as variáveis da seção env usada para modelos. Padrão: [].

--connection, -c, --environment TEXT

Nome da conexão, conforme definido no arquivo config.toml. Padrão: default.

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

--workload-identity-provider TEXT

Provedor de identidade de carga de trabalho (AWS, AZURE, GCP, OIDC). 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 TEXT

Token OAuth a ser usado ao se conectar ao Snowflake.

--token-file-path TEXT

Caminho para o arquivo com um token OAuth a ser usado ao se conectar 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 uma 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

Se deve gerar um relatório de diagnóstico de conexão. Padrão: falso.

--diag-log-path TEXT

Caminho para o relatório gerado. O padrão é o diretório temporário do sistema. Padrão: <system_temporary_directory>.

--diag-allowlist-path TEXT

Caminho para um arquivo JSON que contém parâmetros da lista de permissões.

--oauth-client-id TEXT

Valor do ID de cliente fornecido pelo provedor de identidade para integração com o Snowflake.

--oauth-client-secret TEXT

Valor do segredo do cliente fornecido pelo provedor de identidade para integração com o Snowflake.

--oauth-authorization-url TEXT

Ponto de extremidade do provedor de identidade que fornece o código de autorização ao driver.

--oauth-token-request-url TEXT

Ponto de extremidade do provedor de identidade que fornece os tokens de acesso ao driver.

--oauth-redirect-uri TEXT

URI a ser usado para redirecionamento de código de autorização.

--oauth-scope TEXT

Escopo solicitado na solicitação de autorização do provedor de identidade.

--oauth-disable-pkce

Desativa o Proof Key for Code Exchange (PKCE). Padrão: False.

--oauth-enable-refresh-tokens

Permite uma reautenticação silenciosa quando o token de acesso real fica desatualizado. Padrão: False.

--oauth-enable-single-use-refresh-tokens

Se o usuário deve optar pela semântica de token de atualização de uso único. Padrão: False.

--client-store-temporary-credential

Armazena a credencial temporária.

--format [TABLE|JSON|JSON_EXT|CSV]

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.

--enhanced-exit-codes

Diferencia os códigos de erro de saída com base no tipo de falha. 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ê.

• 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 a versão :codenowrap: definida no arquivo manifest.yml do aplicativo.

• Se você especificar uma versão nomeada, como snow app version create my_version, o campo version no arquivo manifest.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"