snow spcs service deploy¶

Note

Vous pouvez utiliser Snowpark Container Services à partir de Snowflake CLI uniquement si vous disposez des autorisations nécessaires pour utiliser Snowpark Container Services.

Déploie un service défini dans le fichier de définition du projet.

Syntaxe¶

snow spcs service deploy
  <entity_id>
  --upgrade
  --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

Arguments¶

entity_id: ID de l’entité du service.

Options¶

--upgrade: Met à jour le service existant. Peut mettre à jour min_instances, max_instances, query_warehouse, auto_resume, external_access_integrations et le commentaire. Par défaut : false.
-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 spcs service deploy lit un snowflake.yml fichier de définition de projet qui définit un service, puis crée et déploie le pool de calcul vers une zone en préparation nommée dans le fichier snowflake.yml. Si la définition de votre projet ne comporte qu’une seule entité de service, vous pouvez omettre l’argument <entity_id>. Toutefois, si votre définition de projet comporte plusieurs entités de service, vous devez spécifier le nom du service dans l’argument <entity_id>. Pour plus d’informations, voir Définition du projet de service.

Vous pouvez éventuellement choisir d’exécuter plus d’une instance de votre service. Chaque instance de service est une collection de conteneurs, tels que définis dans le fichier de spécification du service, qui s’exécutent ensemble sur un nœud de votre pool de calcul. Si vous choisissez d’exécuter plusieurs instances d’un service, un équilibreur de charge gère le trafic entrant.

L’option --upgrade met à jour un service existant. Vous ne pouvez mettre à jour que les paramètres de définition de projet suivants :

min_instances
max_instances
query_warehouse
auto_resume
external_access_integrations
commentaire

Exemples¶

L’exemple suivant crée et déploie un service défini dans le fichier snowflake.yml dans le répertoire actuel.

snow spcs service deploy

Copy

+---------------------------------------------------------------------+
| key    | value                                                      |
|--------+------------------------------------------------------------|
| status | Service MY_SERVICE successfully created.                   |
+---------------------------------------------------------------------+