Différences entre sfsql et SnowSQL¶

SnowSQL (snowsql) provides many improvements and enhancements over the sfsql command-line interface, including more intuitive option and command names. This topic lists differences in usage between the two command-line clients.

Dans ce chapitre :

Command-line options¶

Many of the command-line options in SnowSQL are backward-compatible with the corresponding options in sfsql; however, there are key differences, as described in the following table:

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 `/* ... */`