PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

  • Présentation
  • Comment le faire ?
  • Créer une requête en code SQL
  • Rétro-analyse de la requête en code SQL
  • Modes d'exécution d'une requête en code SQL
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Autres
Procédures stockées
Présentation
L'éditeur de requêtes permet de créer une requête en saisissant du code SQL (si vous maîtrisez ce langage).

Important

Le logiciel Etats & Requêtes ne permet pas de créer des requêtes en code SQL utilisant les ordres INSERT, UPDATE ou DELETE.
Pour plus de détails sur le langage SQL, consultez les Commandes SQL disponibles dans une requête SQL.
Remarque : A partir de la version 19, HFSQL est le nouveau nom de HyperFileSQL.
Comment le faire ?

Créer une requête en code SQL

Pour créer une requête en code SQL :
  1. Sélectionnez l'option "Fichier .. Nouveau .. Requête". L'assistant de création d'une requête se lance.Cliquez sur parmi les boutons d'accès rapide.
    • Dans la roue qui s'affiche, cliquez sur "Requêtes". La fenêtre de création d'un nouvel élément s'affiche : cliquez sur "Requête".
    • L'assistant de création d'une requête se lance.
  2. Choisissez de créer une requête en saisissant directement le code SQL (option "Code SQL").
  3. Si votre projet n'est pas lié à une analyse, spécifiez l'analyse à laquelle la requête doit être rattachée.
    Validez l'écran de l'assistant.
  4. Saisissez le nom de la requête (nom du fichier ".WDR" correspondant à la requête). Ce nom permettra d'identifier la requête dans vos programmes.
  5. Spécifiez le libellé de la requête en décrivant succinctement le rôle de la requête. Ce libellé sera utilisé dans le dossier du projet.
    Remarque : Le nom de la requête se définit automatiquement à partir du libellé saisi.
  6. Validez la création de la requête. Une fenêtre de code s'affiche.
  7. Saisissez le code SQL de votre requête. Il est possible d'insérer dans la requête :
    • des commentaires en les faisant précéder des caractères "--" ou "//". Seuls les commentaires sur les conditions de sélection seront pris en compte lors de la rétro-analyse de la requête : les autres commentaires seront automatiquement supprimés. Les commentaires sur les conditions de sélection paramétrées ne seront pas proposés lors du GO de la requête.
    • des fonctions WLangage. Il suffit de préfixer les fonctions WLangage utilisées par les lettres "WL.". La saisie assistée est disponible. Les fonctions WLangage peuvent être imbriquées. Exemple :
      SELECT Client.NumClient FROM Client
      WHERE WL.Gauche(Client.CodePostal,2)=34

      AndroidWidget AndroidJava Il n'est pas possible d'exécuter des requêtes dont le code SQL contient des fonctions WLangage.
  8. Sauvegardez le code SQL (Enregistrer).

Rétro-analyse de la requête en code SQL

La rétro-analyse de la requête en code SQL permet de représenter graphiquement la requête à partir des fichiers présents dans le code SQL et dans l'analyse du projet.
Pour effectuer la rétro-analyse d'une requête en code SQL :
  1. Affichez le code SQL de la requête.
  2. Cliquez sur l'icône Rétro-analyse SQL pour représenter graphiquement la requête (ou sélectionnez l'option "Requête .. Rétro-analyse de la requête").Pour représenter graphiquement la requête, sous le volet "Requête", dans le groupe "Analyser", cliquez sur "Rétro-Analyse".
Limites :
  • Cette fonctionnalité est disponible pour les requêtes de type SELECT, UPDATE, DELETE et INSERT.
  • Les sous-requêtes ne sont pas importées.
  • Les requêtes de requêtes ne sont pas gérées.
  • Les requêtes UNION ne sont pas gérées.
  • Cette fonctionnalité est disponible uniquement si les commandes SQL utilisées dans la requête sont reconnues par le moteur HFSQL. Pour plus de détails, consultez les Commandes SQL disponibles dans une requête SQL.
Modes d'exécution d'une requête en code SQL
L'éditeur de requêtes permet d'exécuter simplement des requêtes en code SQL. Ces requêtes peuvent être :
  • soit saisies directement sous l'éditeur de requêtes. La requête est alors exécutée avec la fonction HExécuteRequête.
  • soit directement saisies dans la fonction HExécuteRequêteSQL dans l'éditeur de code.
Deux modes d'exécution des requêtes SQL sont disponibles :
  • Exécution d'une requête SQL avec vérification du code SQL : Cette option est disponible par défaut pour toutes les requêtes SQL exécutées depuis WINDEV. Le code SQL de la requête doit utiliser uniquement les commandes listées ci-dessous. Dans ce cas, le moteur HFSQL effectue une vérification du code SQL de la requête.
  • Exécution d'une requête SQL sans vérification du code SQL (utilisation de la constante hRequêteSansCorrection) : Cette option est conseillée pour les requêtes exécutées via un accès natif ou OLE DB. Dans ce cas, le moteur HFSQL n'effectue aucune vérification de la requête. Cette option doit être utilisée si la requête comporte des ordres spécifiques à un type de connexion (Oracle, SQL Server, ...). Toutes les commandes SQL supportées par la base de données accédée sont utilisables.
Remarque : La constante hRequêteSansCorrection est également disponible lors du test d'une requête depuis l'éditeur de requêtes :
  • pour une requête de sélection : cliquez sur le bouton "Avancé" de la fenêtre de description et cochez l'option "Exécuter avec hRequêteSansCorrection en mode test" dans l'onglet "hRequêteSansCorrection".
  • pour une requête d'insertion, de modification ou de suppression : affichez l'onglet "Général" de la fenêtre de description et cochez l'option "Exécuter avec hRequêteSansCorrection en mode test".
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire