4D v16.3

SQL SET OPTION

Accueil

 
4D v16.3
SQL
SQL SET OPTION

SQL SET OPTION 


 

SQL SET OPTION ( option ; valeur ) 
Paramètre Type   Description
option  Entier long in Numéro d’option à définir
valeur  Entier long, Chaîne in Nouvelle valeur de l’option

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 :

Constante Type Valeur Comment
SQL asynchronous Entier long 1 0 = connexion synchrone (valeur par défaut), 1 (ou valeur différente de 0) = connexion asynchrone
SQL charset Entier long 100 Encodage 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 timeout Entier long 5 Duré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 length Entier long 3 Longueur maximale des données retournées
SQL max rows Entier long 2 Nombre maximum de lignes dans l’ensemble résultant (utilisé pour les prévisualisations)
SQL query timeout Entier long 4 Duré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é.

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

 
PROPRIÉTÉS 

Produit : 4D
Thème : SQL
Numéro : 818

Cette commande modifie la variable système OK

 
HISTORIQUE 

Modifié : 4D v11 SQL Release 4

 
UTILISATION DE L'ARTICLE

4D - Langage ( 4D v16)
4D - Langage ( 4D v16.1)
4D - Langage ( 4D v16.2)
4D - Langage ( 4D v16.3)