4D v14.3SQL EXECUTER SCRIPT |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
4D v14.3
SQL EXECUTER SCRIPT
|
SQL EXECUTER SCRIPT ( cheminScript ; actionErreur {; nomAttribut ; valAttribut} {; nomAttribut2 ; valAttribut2 ; ... ; nomAttributN ; valAttributN} ) | ||||||||
Paramètre | Type | Description | ||||||
cheminScript | Texte |
![]() |
Chemin d'accès complet du fichier contenant le script SQL à exécuter | |||||
actionErreur | Entier long |
![]() |
Action à effectuer en cas d’erreur durant l’exécution du script | |||||
nomAttribut | Texte |
![]() |
Nom d’attribut à utiliser | |||||
valAttribut | Texte |
![]() |
Valeur de l’attribut | |||||
La commande SQL EXECUTER SCRIPT vous permet d’exécuter une suite d’instructions SQL placées dans le fichier de script désigné par cheminScript. Cette commande ne peut être exécutée que sur un poste local (4D local ou procédure stockée sur 4D Server). Elle fonctionne avec la base courante (base interne ou base externe).
Note : Cette commande ne peut pas être utilisée avec une connexion externe ouverte directement ou via ODBC.
Passez dans le paramètre cheminScript le chemin d’accès complet du fichier texte contenant les instructions SQL à exécuter. Le chemin d’accès doit être exprimé à l’aide de syntaxe du système courant. Si vous passez une chaîne vide ("") dans cheminScript, une boîte de dialogue standard d’ouverture de documents s’affiche, permettant à l’utilisateur de sélectionner le fichier de script à exécuter.
Note : Les commandes SQL EXPORTER BASE et SQL EXPORTER SELECTION génèrent automatiquement ce fichier de script.
Le paramètre actionErreur vous permet de paramétrer le fonctionnement de la commande lorsqu’elle rencontre une erreur au cours de l’exécution du script. Vous pouvez passer l’une des trois constantes ci-dessous, placées dans le thème SQL :
Constante | Type | Valeur | Commentaire |
SQL abandonner si erreur | Entier long | 1 | En cas d’erreur, 4D stoppe immédiatement l’exécution du script. |
SQL confirmer si erreur | Entier long | 2 | En cas d’erreur, 4D affiche une boîte de dialogue détaillant l’erreur et permettant à l’utilisateur d’interrompre ou de poursuivre l’exécution du script. |
SQL continuer si erreur | Entier long | 3 | En cas d’erreur, 4D l’ignore et poursuit l’exécution du script. |
Les paramètres nomAttribut et valAttribut doivent être passés par paires. Ces paramètres sont destinés à permettre de définir des attributs spécifiques pour l’exécution du script. Dans la version actuelle de 4D, un seul attribut peut être passé dans nomAttribut, disponible via la constante suivante, placée dans le thème SQL :
Constante | Type | Valeur | Commentaire |
SQL utiliser les droits d’accès | Chaîne | SQL_Use_Access_Rights | Permet de restreindre les droits d’accès à appliquer lors de l’exécution des commandes SQL du script. Lorsque vous utilisez cet attribut, vous devez passer 0 ou 1 dans valAttribut :
|
Si le fichier d’enregistrement des requêtes de 4D est activé (via les sélecteurs 28 ou 45 de la commande FIXER PARAMETRE BASE), chaque commande SQL exécutée génèrera une entrée avec les informations suivantes :
Si le script est correctement exécuté (aucune erreur rencontrée), la variable système OK prend la valeur 1. En cas d’erreur, la variable système OK prend ou non la valeur 0 en fonction du paramètre actionErreur :
Note : Si vous utilisez cette commande pour exécuter des actions consommatrices de mémoire telles que l’importation massive de données, vous pouvez envisager de faire appel à la nouvelle commande SQL ALTER DATABASE afin de désactiver temporairement des options SQL.
Produit : 4D
Thème : SQL
Numéro :
1089
Nom intl. : SQL EXECUTE SCRIPT
Créé : 4D v12
4D - Langage ( 4D v12.4)
4D - Langage ( 4D v14 R3)
4D - Langage ( 4D v14 R2)
4D - Langage ( 4D v13.5)
4D - Langage ( 4D v14.3)
4D - Langage ( 4D v14 R4)