snow app release-directive set¶
Define uma diretriz de versão.
Sintaxe¶
snow app release-directive set
<directive>
--channel <channel>
--target-accounts <target_accounts>
--version <version>
--patch <patch>
--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¶
directive
Nome da diretriz de versão a ser definida.
Opções¶
--channel TEXT
Nome do canal de lançamento a ser usado. Padrão: DEFAULT.
--target-accounts TEXT
Lista das contas às quais aplicar a diretriz de versão. O formato deve ser
org1.account1,org2.account2
.--version TEXT
Versão do pacote de aplicativo a ser usada.
--patch INTEGER
Número do patch a ser usado para a versão selecionada.
--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 release-directive set
define a diretriz de versão de um pacote de aplicativo. Há dois tipos de diretrizes de versão: padrão e personalizada.
Quando você define a diretriz de versão padrão, as contas de destino não são aceitas.
Quando você define uma nova diretriz de versão personalizada, as contas de destino são obrigatórias.
Quando você atualiza uma diretriz de versão personalizada existente, as contas de destino são opcionais.
As contas de destino são fornecidas no formato ORGANIZATION_NAME.ACCOUNT_NAME, separadas por vírgulas.
Quando os canais de lançamento estão ativados no pacote do aplicativo, a diretriz de versão tem como escopo o canal de lançamento especificado; caso contrário, ela tem como escopo o pacote do aplicativo.
O Snowflake recomenda o uso do comando snow app publish para publicar o pacote do aplicativo e o uso do comando snow app release-directive set
para criar diretrizes de versão personalizadas. Consulte Publicação de um Snowflake Native App para os clientes para obter mais informações.`
Exemplos¶
Definição da diretriz de versão padrão para um pacote de aplicativo:
snow app release-directive set DEFAULT --version v1 --patch 1
Definição de uma diretriz de versão personalizada para um pacote de aplicativo:
snow app release-directive set CUSTOM_DIR --version v1 --patch 1 --target-accounts ORG1.ACCT1,ORG2.ACCT2
Atualização de uma diretriz de versão personalizada existente para um pacote de aplicativo:
snow app release-directive set CUSTOM_DIR --version v1 --patch 2
Definição da diretriz de versão padrão de um canal de lançamento quando o pacote do aplicativo tiver canais de lançamento ativados:
snow app release-directive set DEFAULT --version v1 --patch 1 --channel ALPHA