snow app publish¶

Syntaxe¶

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

Arguments¶

Aucun(e)

Options¶

--version TEXT

La version à publier sur le canal de diffusion et la directive de version fournis. Il est exigé que la version existe, sauf si l’option --create-version est utilisée.

--patch INTEGER

Le numéro de correctif sous la version donnée. Il sera utilisé lors du paramètre de la directive de version. Il est exigé que le correctif existe déjà, sauf si l’option --create-version est utilisée.

--channel TEXT

Le nom du canal de version sur lequel publier. S’il n’est pas fourni, le canal de version par défaut est utilisé. Par défaut : DEFAULT.

--directive TEXT

Le nom de la directive de version à mettre à jour avec la version et le correctif spécifiés. S’il n’est pas fourni, la directive de version par défaut est utilisée. Par défaut : DEFAULT.

--interactive / --no-interactive

Lorsqu’elle est activée, cette option affiche des invites même si l’entrée et la sortie standard ne sont pas des terminaux. La valeur par défaut est True dans un environnement shell interactif et False dans le cas contraire.

--force

Lorsqu’elle est activée, cette option permet à la commande d’approuver implicitement toutes les invites qui se présentent. Vous devez activer cette option si le mode interactif n’est pas spécifié et si vous souhaitez effectuer des actions potentiellement destructrices. La valeur par défaut est « non définie ». Par défaut : false.

--create-version

Créez une nouvelle version ou un nouveau correctif sur la base des valeurs fournies --version et --patch. Retour aux valeurs du manifeste si elles ne sont pas fournies. Par défaut : false.

--from-stage

Lorsque cette option est activée, la CLI Snowflake crée une version à partir de la zone de préparation actuelle du paquet d’application sans synchronisation préalable avec la zone de préparation. Ne peut être utilisé qu’avec l’option --create-version. Par défaut : false.

--label TEXT

Une étiquette pour la version qui est présentée aux consommateurs. Ne peut être utilisé qu’avec l’option --create-version.

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

--workload-identity-provider TEXT

Fournisseur d’identité de charge de travail (AWS, AZURE, GCP, OIDC). 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 TEXT

Jeton OAuth à utiliser lors de la connexion à Snowflake.

--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|JSON_EXT|CSV]

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 publish vous permet d’ajouter des versions Snowflake Native App à un canal de version et définit la directive de version sélectionnée pour utiliser la version et le correctif fournis.

Pour plus d’informations sur les canaux et les directives de version, voir Publication d’une Snowflake Native App à l’intention des clients.

Cette commande ajoute la version spécifiée au canal de version. Si le canal de version a atteint son nombre maximal de versions, la version la plus ancienne qui n’est référencée par aucune directive de version est supprimée du canal de version. Une fois la version ajoutée au canal de version, la directive de version au sein du canal de version est mise à jour pour utiliser la version et le correctif fournis.

Si les canaux de version ne sont pas activés pour le paquet d’application, seule la directive de version est mise à jour pour utiliser la version et le correctif fournis. Lorsqu’un canal de version n’est pas fourni, ou lorsque vous utilisez le canal de version par défaut, vous pouvez utiliser les mêmes commandes, que les canaux de version soient activés ou non.

Cette commande suppose que la version et le correctif existent déjà dans le paquet d’application. Si la version et le correctif n’existent pas, la commande échoue.

Pour créer une nouvelle version ou un nouveau correctif lors de l’utilisation de cette commande, utilisez l’option --create-version. En utilisant cette option, vous pouvez utiliser des options comme --from-stage ou --label. Pour plus d’informations, consultez également la commande snow app version create.

Les règles de création d’une nouvelle version sont les mêmes que pour la commande snow app version create. En d’autres termes, Snowflake CLI utilise la même logique de rappel sur le fichier manifeste si le champ de la version est manquant.

Exemples¶

• Publiez la version v1 et le correctif 2 dans la directive de version par défaut du canal de versionn par défaut ou dans la directive de version par défaut du paquet. Dans cet exemple, les canaux de version ne sont pas activés :

  snow app publish --version v1 --patch 2
  

  Copy

• Publiez la version v1 et le correctif 2 dans la directive de version customers_group_1 du canl de version ALPHA :

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

  Copy

• Publiez la version v1 et le correctif 2 dans la directive de version par défaut du canal de version QA :

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

  Copy

• Créez une nouvelle version et publiez-la dans la directive de version personnalisée early_adopters du canal de version par défaut :

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

  Copy

• Ajoutez un correctif à une version existante et publiez-le dans la directive de version par défaut du canal de version par défaut. Vous devez utiliser --create-version et fournir le numéro de patch ou l’omettre pour utiliser le prochain numéro de patch disponible :

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

  Copy

• Créez un nouveau correctif à partir du contenu de la zone de préparation sans synchroniser les fichiers avec la zone de préparation au préalable, et publiez-le dans la directive de version par défaut du canal de version par défaut :

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

  Copy