snow app deploy¶
Cria um pacote de aplicativo na sua conta Snowflake e sincroniza as alterações locais no estágio sem criar ou atualizar o aplicativo. A execução deste comando sem nenhum argumento, como em snow app deploy
, é uma abreviação de snow app deploy --prune --recursive
.
Sintaxe¶
snow app deploy
<paths>
--prune / --no-prune
--recursive / --no-recursive
--interactive / --no-interactive
--force
--validate / --no-validate
--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¶
paths...
Caminhos, relativos à raiz do projeto, de arquivos ou diretórios que você deseja enviar para um estágio. Se um arquivo for especificado, ele deverá corresponder a uma das entradas do padrão src de artefatos em snowflake.yml. Se um diretório for especificado, ele será pesquisado em busca de subpastas ou arquivos para implementação com base nas entradas do padrão src dos artefatos. Se não for especificado, o comando sincroniza todas as alterações locais no estágio.
Opções¶
--prune / --no-prune
Se os arquivos especificados devem ser excluídos do estágio caso eles não existam localmente. Se definido, o comando exclui arquivos que existem no estágio, mas não no sistema de arquivos local. Esta opção não pode ser usada quando caminhos são especificados.
--recursive, -r / --no-recursive
Se deve percorrer e implantar arquivos de subdiretórios. Se definido, o comando implanta todos os arquivos e subdiretórios; caso contrário, somente os arquivos no diretório atual são implantados.
--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.
--validate / --no-validate
Quando ativada, esta opção aciona a validação de script de configuração SQL de um Snowflake Native App implementado. Padrão: Verdadeiro.
--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¶
O comando snow app deploy
cria um pacote de aplicativo em sua conta Snowflake, carrega arquivos de código para seu estágio, valida o script de configuração SQL e executa quaisquer ganchos implementados posteriormente definidos em snowflake.yml
. Ao contrário do comando snow app run, este comando não instala ou atualiza um objeto de aplicativo.
Exemplos¶
Se você quiser criar um pacote de aplicativo usando arquivos preparados, você pode executar:
cd my_app_project
my_app_project_build_script.sh
snow app deploy --connection="dev"