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 répertorie les différences d’utilisation entre les deux clients de ligne de commande.

Note

sfsql est maintenant obsolète. Utilisez SnowSQL à la place.

Dans ce chapitre :

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)

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