snow app version create¶

Syntaxe¶

snow app version create
  <version>
  --patch <patch>
  --skip-git-check
  --interactive / --no-interactive
  --force
  --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

Arguments¶

version

Version à définir dans votre paquet d’application. Si la version existe déjà, un correctif auto-incrémenté est ajouté à la version. La version par défaut est celle spécifiée dans le fichier manifest.yml.

Options¶

--patch INTEGER

Le numéro de correctif que vous souhaitez créer pour une version existante. La valeur par défaut est undefined si elle n’est pas définie, ce qui signifie que CLI Snowflake utilise le correctif spécifié dans le fichier manifest.yml ou génère automatiquement un nouveau numéro de correctif.

--skip-git-check

Lorsque cette option est activée, CLI Snowflake ne vérifie pas si votre projet a des fichiers en zone de préparation ou non suivis dans git. Valeur par défaut : non définie. Par défaut : false.

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

--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é de l’application sur laquelle opérer lorsque definition_version est la 2 ou supérieure.

-p, --project TEXT

Chemin où réside le projet Snowflake. 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 vers un fichier avec un jeton OAuth qui doit être utilisé 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 la connexion définie avec les paramètres de la ligne de commande, au lieu de celle définie dans la configuration. Par défaut : false.

--mfa-passcode TEXT

Jeton à utiliser pour l’authentification multifactorielle (MFA)

--enable-diag

Exécutez le test de diagnostic du Python Connector. Par défaut : false.

--diag-log-path TEXT

Chemin d’accès au rapport de diagnostic. Par défaut : <temporary_directory>.

--diag-allowlist-path TEXT

Chemin d’accès au rapport de diagnostic vers la liste d’autorisations facultative.

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

--help

Affiche le texte d’aide de cette commande.

Notes sur l’utilisation¶

Cette commande crée un paquet d’application (s’il n’existe pas) avec une version et un correctif optionnel.

• Si vous ne fournissez pas de version, la commande utilise la version spécifiée dans le fichier manifest.yml. Si la version n’est pas présente dans le fichier manifest.yml, la commande génère une erreur.

• Si vous fournissez à la fois l’argument de la version et l’option --patch, et que le paquet d’application n’existe pas encore, la commande génère une erreur. Vous ne devez fournir l’argument de la version que pour créer un nouveau paquet d’application avec la version requise.

• Si vous fournissez à la fois l’argument de version et l’option --patch, et que la version n’existe pas encore, la commande génère une erreur. Vous ne devez fournir l’argument de version que pour créer une nouvelle version avec un correctif 0 prédéterminé.

• Si vous travaillez dans un référentiel Git et que vous exécutez cette commande, celle-ci vérifie les modifications locales apportées à votre copie de travail. S’il détecte des modifications locales, il vous invite à confirmer si vous pouvez poursuivre en toute sécurité. Vous pouvez ignorer cette vérification en utilisant l’option --skip-git-check.

• Si le paquet d’application n’existe pas, un nouveau est créé par Snowflake CLI et est libellé par un commentaire spécial GENERATED_BY_SNOWCLI. Il exécute également les éventuels scripts post-déploiement et charge les fichiers de code vers la zone de préparation.

• Si le paquet d’application existe déjà et que sa propriété de distribution est INTERNAL, la commande vérifie si le paquet a été créé par Snowflake CLI. Dans le cas contraire, la commande génère une erreur. Si la distribution du paquet d’application est EXTERNAL, aucune vérification de ce type n’est effectuée.

• La commande vous avertit si le paquet d’application avec lequel vous travaillez a une valeur de distribution différente de celle définie dans la définition de votre projet résolu, mais poursuit l’exécution.

• Si la version est référencée dans une directive de version du paquet d’application, la commande vous invite à confirmer si vous souhaitez créer un correctif sur cette version.

• Si la version existe déjà et que vous ne fournissez pas d’option --patch, le Native Apps Framework incrémente automatiquement le numéro de correctif de cette version existante. Sinon, il crée un correctif personnalisé sous la version que vous avez fournie.

Exemples¶

Ces exemples supposent que vous avez apporté les modifications nécessaires à vos fichiers de code et que vous les avez ajoutés à vos fichiers snowflake.yml ou snowflake.local.yml.

Si vous souhaitez créer un paquet d’application et y ajouter une version V1, utilisez la commande suivante :

snow app version create V1 --connection="dev"

Vous pouvez également utiliser la commande ci-dessus pour créer une version V1 sur un paquet d’application existant.

Si vous souhaitez ajouter un correctif à la version V1 en utilisant la fonctionnalité d’auto-incrémentation et en invoquant le mode interactif, utilisez la commande suivante :

snow app version create V1 --interactive --connection="dev"

Si vous souhaitez ajouter un numéro de correctif personnalisé à la version V1 et contourner le mode interactif même si vous êtes dans un shell interactif, utilisez la commande suivante :

snow app version create V1 --patch 42 --force --connection="dev"