Différences entre sfsql et SnowSQL¶

SnowSQL (snowsql) fournit de nombreuses améliorations au niveau de l’interface de ligne de commande sfsql, y compris des noms d’options et de commandes plus intuitifs. Ce chapitre liste les différences d’utilisation entre les deux clients de ligne de commande.

Dans ce chapitre :

Options de ligne de commande
Commandes
Caractères spéciaux

Options de ligne de commande¶

De nombreuses options de ligne de commande dans SnowSQL sont rétrocompatibles avec les options correspondantes dans sfsql. Cependant, il existe des différences clés, comme décrit dans le tableau suivant :

Option	`sfsql`	SnowSQL (`snowsql`)
Identificateur du compte	`-a`	`-a` , `--accountname`
Nom d’utilisateur	`-u`	`-u` , `--username`
Mot de passe	`-c`	N/A (utiliser la variable d’environnement SNOWSQL_PWD)
Demande de mot de passe	N/A	`-P`
Base de données	`-d`	`-d` , `--dbname`
Schéma	`-s`	`-s` , `--schemaname`
Entrepôt	`-w`	`-w` , `--warehouse`
Rôle	`-r`	`-r` , `--rolename`
Nom d’hôte	`-g`	`-h` , `--host`
Numéro de port	`-p`	`-p` , `--port`
Code d’accès MFA	`-m`	`-m` , `--mfa-passcode`
Code d’accès MFA dans le mot de passe	`-n`	`--mfa-passcode-in-password`
Expliquer une SQL	`-e` (non pris en charge)	N/A
Expliquer un SQL sous forme de point	`-x` (non pris en charge)	N/A
Exécuter un fichier SQL	`-f`	`-f` , `--filename`
Arrêter en cas d’erreur	N/A	`-o stop_on_error=true`
Quitter en cas d’erreur	`-k`	`-o exit_on_error=true`
Authentificateur	`-b`	`--authenticator`
Utiliser une connexion définie par l’utilisateur	N/A	`-c` , `--connection`
Niveau de trace	`-t`	`-o log_level=(INFO\|DEBUG)`
Afficher la version CLI	N/A	`-v` , `--version`
Utiliser la configuration spécifiée	N/A	`--config`
Définir les options	N/A	`-o` , `--option`
Variables d’ensemble	N/A	`-D` , `--variable`
Aide	`-h`	`-?` , `--help`

Commandes¶

Pour les commandes, la différence principale est que toutes les commandes dans SnowSQL doivent être précédées d’un point d’exclamation (par ex. !exit). De plus, les noms de certaines commandes ont été modifiés.

Commande	`sfsql`	SnowSQL (`snowsql`)
Charger et exécuter un fichier SQL	`load` , `@`	`!source` , `!load`
Imprimer un message	`echo`	`!print`
Définir une option	N/A	`!set`
Afficher toutes les options	N/A	`!options`
Définir une variable	`set-var`	`!define`
Annuler la définition d’une variable	`unset-var`	N/A
Afficher toutes les variables	N/A	`!variables`
Se connecter et lancer une nouvelle session	`connect`	`!connect`
Quitter la session en cours	N/A	`!exit` , `!disconnect` (voir aussi `!quit`)
« Spooler » la sortie vers un fichier	`spool`	`!spool`
Quitter le CLI	`exit` , `quit`	`!quit`
Exécute une commande système	`system`	`!system`
Aide	`help`	`!help`

Caractères spéciaux¶

Les caractères suivants ont une signification particulière dans les deux clients :

Utilisation	`sfsql`	SnowSQL (`snowsql`)
Préfixe pour les noms de variable	`$`	`&&`
Désactiver les commentaires dans le code	`#`	`--` et `/* ... */`