snow app publish¶

Sintaxe¶

snow app publish
  --version <version>
  --patch <patch>
  --channel <channel>
  --directive <directive>
  --interactive / --no-interactive
  --force
  --create-version
  --from-stage
  --label <label>
  --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¶

Nenhum

Opções¶

--version TEXT

A versão a ser publicada no canal de lançamento e na diretriz de versão fornecidos. É necessário que a versão exista, a menos que o sinalizador --create-version seja usado.

--patch INTEGER

O número do patch na versão fornecida. Isso será usado ao definir a diretriz de versão. É necessário que o patch exista, a menos que o sinalizador --create-version seja usado.

--channel TEXT

O nome do canal de lançamento para o qual publicar. Se não for fornecido, será usado o canal de lançamento padrão. Padrão: DEFAULT.

--directive TEXT

O nome da diretriz de versão a ser atualizada com a versão e o patch especificados. Se não for fornecida, será usada a diretriz de versão padrão. Padrão: DEFAULT.

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

--create-version

Crie uma nova versão ou patch com base nos valores fornecidos --version e --patch. Fallback aos valores do manifesto se não forem fornecidos. 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. Só pode ser usado com o sinalizador --create-version. Padrão: falso.

--label TEXT

Um rótulo para a versão que é exibida aos consumidores. Só pode ser usado com o sinalizador --create-version.

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

O comando snow app publish permite adicionar versões de Snowflake Native App a um canal de lançamento e, em seguida, define a diretriz de versão selecionada para usar a versão e o patch fornecidos.

Para obter mais informações sobre os canais de lançamento e as diretrizes de versão, consulte Publicação de um Snowflake Native App para os clientes.

Esse comando adiciona a versão especificada ao canal de lançamento. Se o canal de lançamento tiver atingido o número máximo de versões, a versão mais antiga não referenciada por nenhuma diretriz de versão será removida do canal de lançamento. Depois que a versão é adicionada ao canal de lançamento, a diretriz de versão dentro do canal de lançamento é atualizada para usar a versão e o patch fornecidos.

Se os canais de lançamento não estiverem ativados para o pacote do aplicativo, somente a diretriz de versão será atualizada para usar a versão e o patch fornecidos. Quando um canal de lançamento não é fornecido ou quando se usa o canal de lançamento padrão, você pode usar os mesmos comandos, quer os canais de lançamento estejam ativados ou não.

Esse comando pressupõe que a versão e o patch já existam no pacote do aplicativo. Se a versão e o patch não existirem, o comando falhará.

Para criar uma nova versão ou patch ao usar esse comando, use a opção --create-version. Ao usar essa opção, você pode usar opções como --from-stage ou --label. Para obter mais informações, consulte também o comando snow app version create.

As regras para a criação de uma nova versão são as mesmas do comando snow app version create. Em outras palavras, o Snowflake CLI usa a mesma lógica de fallback para o arquivo de manifesto se o campo de versão estiver ausente.

Exemplos¶

• Publique a versão v1 e o patch 2 na diretriz de versão padrão do canal de lançamento padrão ou na diretriz de versão padrão do pacote. Neste exemplo, os canais de lançamento não estão ativados:

  snow app publish --version v1 --patch 2
  

  Copy

• Publique a versão v1 e o patch 2 na diretriz de versão customers_group_1 do canal de lançamento ALPHA:

  snow app publish --version v1 --patch 2 --channel ALPHA --directive customers_group_1
  

  Copy

• Publique a versão v1 e o patch 2 na diretriz de versão padrão do canal de lançamento QA:

  snow app publish --version v1 --patch 2 --channel QA
  

  Copy

• Crie uma nova versão e publique-a na diretriz de versão personalizada early_adopters do canal de lançamento padrão:

  snow app publish --version v2 --create-version --directive early_adopters
  

  Copy

• Adicione um patch a uma versão existente e publique-o na diretriz de versão padrão do canal de lançamento padrão. Você deve usar --create-version e fornecer o número do patch ou omiti-lo para usar o próximo número de patch disponível:

  snow app publish --version v2 --create-version
  

  Copy

• Crie um novo patch a partir do conteúdo do estágio sem sincronizar os arquivos com o estágio primeiro e publique-o na diretriz de versão padrão do canal de lançamento padrão:

  snow app publish --version v2 --patch 11 --create-version --from-stage
  

  Copy