SQL SET OPTION
SQL SET OPTION* ( option ; valeur )
| Paramètre | Type | Description | |
|---|---|---|---|
| option | Integer | → | Numéro d’option à définir |
| valeur | Integer, Text | → | Nouvelle valeur de l’option |
Description
a 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é.
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
Propriétés
| Numéro de commande | 818 |
| Thread safe | ✗ |
| Modifie les variables | OK |