Aller au contenu principal
Version: Next

SQL SET OPTION

SQL SET OPTION ( option ; valeur )

ParamètreTypeDescription
optionIntegerNuméro d’option à définir
valeurInteger, TextNouvelle valeur de l’option

Cette commande n'est pas thread-safe, elle ne peut pas être utilisée dans du code préemptif.

Description

La commande SQL SET OPTION permet de modifier la valeur de l’option passée dans le paramètre option.

Vous pouvez passer dans option l’une des constantes suivantes, placées dans le thème SQL :

ConstanteTypeValeurComment
SQL asynchronousEntier long10 = connexion synchrone (valeur par défaut), 1 (ou valeur différente de 0) = connexion asynchrone
SQL charsetEntier long100Encodage du texte utilisé pour les requêtes envoyées aux sources externes (via le SQL pass-through). La modification est effective pour le process courant et la connexion courante.
Valeurs possibles : identifiant MIBEnum (cf. note 2) ou valeur -2 (cf. note 3)
Par défaut : 106 (UTF-8)
SQL connection timeoutEntier long5Durée maximale d’attente lors de l’exécution de la commande SQL LOGIN. Cette valeur doit être fixée avant l’ouverture de la connexion pour être prise en compte
Valeurs possibles : durée en secondes
Par défaut : pas de timeout
SQL max data lengthEntier long3Longueur maximale des données retournées
SQL max rowsEntier long2Nombre maximum de lignes dans l’ensemble résultant (utilisé pour les prévisualisations)
SQL query timeoutEntier long4Durée maximale d’attente de la réponse lors de l’exécution de la commande SQL EXECUTER.
Valeurs : durée en secondes
Par défaut : pas de timeout

Notes :
1. Lorsque vous travaillez avec le moteur SQL interne de 4D, l’option SQL Asynchronous est inutile. En effet, ce type de connexion est toujours synchrone.
2. Les numéros MIBEnum sont référencés à l’adresse suivante : http://www.iana.org/assignments/character-sets.
3. Lorsque vous passez -2 comme valeur à SQL Charset, l’encodage utilisé par le serveur SQL de 4D est automatiquement adapté à la plate-forme d’exécution (encodage non-UTF) :

  • sous Windows, ISO8859-1 est utilisé,
  • sous Mac OS, MAC-ROMAN est utilisé.

Variables et ensembles système

Si la commande a été correctement exécutée, la variable système OK retourne 1, sinon elle retourne 0.

Voir aussi

SQL GET OPTION