snow app release-directive set¶
Définit une directive de version. target_accounts ne peut pas être spécifié pour les directives de version par défaut. Le champ target_accounts est requis lors de la création d’une nouvelle directive de version autre que celle par défaut.
Syntaxe¶
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>
--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
Arguments¶
directive
Nom de la directive de version à définir.
Options¶
--channel TEXT
Nom du canal de version à utiliser. Par défaut : DEFAULT.
--target-accounts TEXT
Liste des comptes auxquels appliquer la directive de version. Le format doit être
org1.account1,org2.account2
.--version TEXT
Version du paquet d’application à utiliser.
--patch INTEGER
Numéro du correctif à utiliser pour la version sélectionnée.
--package-entity-id TEXT
L’ID de l’entité du paquet sur laquelle opérer lorsque definition_version est la 2 ou supérieure.
--app-entity-id TEXT
L’ID de l’entité d’application sur laquelle opérer la definition_version est la 2 ou supérieure.
-p, --project TEXT
Chemin où le projet Snowflake est stocké. La valeur par défaut est le répertoire de travail actuel.
--env TEXT
Chaîne au format clé=valeur. Remplace les variables de la section env utilisées pour les modèles. Par défaut : [].
--connection, -c, --environment TEXT
Nom de la connexion, tel que défini dans votre fichier
config.toml
. Défaut :défaut
.--host TEXT
Adresse de l’hôte pour la connexion. Remplace la valeur spécifiée pour la connexion.
--port INTEGER
Port pour la connexion. Remplace la valeur spécifiée pour la connexion.
--account, --accountname TEXT
Nom attribué à votre compte Snowflake. Remplace la valeur spécifiée pour la connexion.
--user, --username TEXT
Nom d’utilisateur pour se connecter à Snowflake. Remplace la valeur spécifiée pour la connexion.
--password TEXT
Mot de passe Snowflake. Remplace la valeur spécifiée pour la connexion.
--authenticator TEXT
Authentificateur Snowflake. Remplace la valeur spécifiée pour la connexion.
--private-key-file, --private-key-path TEXT
Chemin du fichier de clé privée Snowflake. Remplace la valeur spécifiée pour la connexion.
--token-file-path TEXT
Chemin d’accès au fichier contenant un jeton OAuth à utiliser lors de la connexion à Snowflake.
--database, --dbname TEXT
Base de données à utiliser. Remplace la valeur spécifiée pour la connexion.
--schema, --schemaname TEXT
Schéma de la base de données à utiliser. Remplace la valeur spécifiée pour la connexion.
--role, --rolename TEXT
Rôle à utiliser. Remplace la valeur spécifiée pour la connexion.
--warehouse TEXT
Entrepôt à utiliser. Remplace la valeur spécifiée pour la connexion.
--temporary-connection, -x
Utilise une connexion définie avec les paramètres de la ligne de commande, au lieu d’une connexion définie dans la configuration. Par défaut : false.
--mfa-passcode TEXT
Jeton à utiliser pour l’authentification multifactorielle (MFA)
--enable-diag
Indique s’il faut générer un rapport de diagnostic de la connexion. Par défaut : false.
--diag-log-path TEXT
Chemin d’accès au rapport généré. Il s’agit du répertoire temporaire du système par défaut. Par défaut : <system_temporary_directory>.
--diag-allowlist-path TEXT
Chemin d’accès à un fichier JSON contenant les paramètres de la liste d’autorisations.
--oauth-client-id TEXT
Valeur de l’identifiant du client fourni par le fournisseur d’identité pour l’intégration dans Snowflake.
--oauth-client-secret TEXT
Valeur du secret du client fourni par le fournisseur d’identité pour l’intégration dans Snowflake.
--oauth-authorization-url TEXT
Point de terminaison du fournisseur d’identité fournissant le code d’autorisation au pilote.
--oauth-token-request-url TEXT
Point de terminaison du fournisseur d’identité fournissant les jetons d’accès au pilote.
--oauth-redirect-uri TEXT
URI à utiliser pour la redirection du code d’autorisation.
--oauth-scope TEXT
Champ d’application demandé dans la requête d’autorisation du fournisseur d’identité.
--oauth-disable-pkce
Désactive la clé de preuve pour l’échange de code (PKCE). Par défaut :
False
.--oauth-enable-refresh-tokens
Permet une réauthentification silencieuse lorsque le jeton d’accès actuel n’est plus valable. Par défaut :
False
.--oauth-enable-single-use-refresh-tokens
Indique s’il faut choisir une sémantique de jeton d’actualisation à usage unique. Par défaut :
False
.--client-store-temporary-credential
Enregistrez les identifiants de connexion temporaires.
--format [TABLE|JSON]
Spécifie le format de sortie. Par défaut : TABLE.
--verbose, -v
Affiche les entrées de journal pour les niveaux de journalisation
info
et supérieurs. Par défaut : false.--debug
Affiche les entrées de journal pour les niveaux de journalisation
debug
et supérieurs ; les journaux de débogage contiennent des informations supplémentaires. Par défaut : false.--silent
Désactive la sortie intermédiaire vers la console. Par défaut : false.
--enhanced-exit-codes
Différenciez les codes d’erreur de sortie en fonction du type d’erreur. Par défaut : false.
--help
Affiche le texte d’aide de cette commande.
Notes sur l’utilisation¶
La commande snow app release-directive set
définit la directive de version d’un paquet d’application. Il existe deux types de directives de version : les directives par défaut et les directives personnalisées.
Lorsque vous avez défini la directive de version par défaut, les comptes cibles ne sont pas acceptés.
Lorsque vous définissez une nouvelle directive de version personnalisée, les comptes cibles sont obligatoires.
Lorsque vous mettez à jour une directive de version personnalisée existante, les comptes cibles sont facultatifs.
Les comptes cibles sont fournis sous le format ORGANIZATION_NAME.ACCOUNT_NAME, séparés par des virgules.
Lorsque les canaux de diffusion sont activés dans le paquet d’application, la directive de version est liée au canal de version spécifié ; dans le cas contraire, elle est liée au paquet d’application.
Snowflake recommande d’utiliser la commande snow app publish pour publier le paquet d’application et d’utiliser la commande snow app release-directive set
pour créer des directives de version personnalisées. Pour plus d’informations, voir Publication d’une Snowflake Native App à l’intention des clients.`
Exemples¶
Définissez la directive de version par défaut d’un paquet d’application :
snow app release-directive set DEFAULT --version v1 --patch 1
Définissez une directive de version personnalisée d’un paquet d’application :
snow app release-directive set CUSTOM_DIR --version v1 --patch 1 --target-accounts ORG1.ACCT1,ORG2.ACCT2
Mettez à jour une directive de version personnalisée existante pour un paquet d’application :
snow app release-directive set CUSTOM_DIR --version v1 --patch 2
Définissez la directive de version par défaut d’un canal de version lorsque les canaux de version sont activés dans le paquet d’application :
snow app release-directive set DEFAULT --version v1 --patch 1 --channel ALPHA