snow app release-directive set¶

Define uma diretiva de lançamento. target_accounts não pode ser especificado para diretivas de lançamento padrão. O campo target_accounts é necessário ao criar uma nova diretiva de lançamento não padrã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>
  --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

Copy

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

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
Copy

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

Copy

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