DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Gestion des bases de données / Fonctions SQL
  • Détail des informations sur les colonnes
  • Astuce : Comment accélérer le temps d'exécution de la fonction SQLColonne ?
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
Renvoie les caractéristiques de toutes les colonnes (ou rubriques) :
  • soit d'une table donnée.
  • soit d'une requête donnée.
WEBDEV - Code Navigateur Les fonctions SQL permettent de manipuler des bases de données locales (de type Web SQL database). Pour plus de détails, consultez Accès en mode local à une base de données (SQLite).
WEBDEV - Code Navigateur La fonction SQLColonne renvoie uniquement les caractéristiques des colonnes d'une requête donnée. La requête doit avoir renvoyé un résultat pour obtenir ses caractéristiques.
Exemple
// Connexion à une base de données
Numéro_Connexion est un entier
Numéro_Connexion = SQLConnecte(NomSource, "", "", "", "ODBC")
i est un entier
// LISTE_ListeTab est une liste contenant la liste des tables
i = LISTE_ListeTab
SI i <> -1 ALORS
ListeAjoute(LISTE_Liste1, SQLColonne(Numéro_Connexion, LISTE_ListeTab[i]))
FIN
Syntaxe
WINDEVWEBDEV - Code ServeurEtats et RequêtesJavaCode Utilisateur (MCU)PHPAjaxHFSQL ClassicHFSQL Client/ServeurHyper File 5.5OLE DBODBCConnecteurs Natifs (Accès Natifs)

Colonnes d'une table donnée Masquer les détails

<Résultat> = SQLColonne(<Numéro de la connexion> , <Nom de la table> [, <Détails>])
<Résultat> : Chaîne de caractères
Nom des colonnes de la table.
  • Si <Détails> vaut Faux, la chaîne de caractères contient le nom de chaque colonne de la table séparé par des RC :
    Colonne1 + RC + Colonne2 + RC + ... + ColonneN
  • Si <Détails> vaut Vrai, la chaîne de caractères contient les noms de chaque colonne de la table avec diverses informations sur la colonne (nom, type, taille) :
    NomColonne + TAB + Type1 (N/T) + TAB + Type2 (numéro) + TAB + Taille + RC

    Ce format est détaillé dans les Remarques.
Java Les résultats concernant les types et les tailles des colonnes peuvent être différents des résultats obtenus en WINDEV.
<Numéro de la connexion> : Entier
Numéro de la connexion à utiliser, renvoyé par la fonction SQLConnecte.
<Nom de la table> : Chaîne de caractères
Nom de la table dont on veut connaître les colonnes.
<Détails> : Booléen optionnel
  • Vrai (option par défaut) pour un résultat détaillé,
  • Faux pour un résultat simplifié.

Colonnes d'une requête donnée Masquer les détails

<Résultat> = SQLColonne(<Nom de la requête> [, <Détails>])
<Résultat> : Chaîne de caractères
  • Si <Détails> vaut Faux, la chaîne de caractères contient le nom de chaque colonne de la table séparé par des RC (Retours Chariot) :
    Colonne1 + RC + Colonne2 + RC + ... + ColonneN
  • Si <Détails> vaut Vrai, la chaîne de caractères contient les noms de chaque colonne de la table avec diverses informations sur la colonne (nom, type, taille) :
    NomColonne + TAB + Type1 (N/T) + TAB + Type2 (numéro) + TAB + Taille + RC

    Ce format est détaillé dans les Remarques.
Java Les résultats concernant les types et les tailles des colonnes peuvent être différents des résultats obtenus en WINDEV.
WEBDEV - Code Navigateur Attention : Si la requête n'a pas renvoyé de résultat, les caractéristiques des colonnes ne peuvent pas être connues.
<Nom de la requête> : Chaîne de caractères
Nom de la requête (exécutée avec la fonction SQLExec ou SQLExecWDR) dont on veut connaître les colonnes.
WEBDEV - Code Navigateur Seules les requêtes créées et exécutées avec la fonction SQLExec sont disponibles.
<Détails> : Booléen optionnel
  • Vrai pour un résultat détaillé,
  • Faux (option par défaut) pour un résultat simple.
Remarques

Détail des informations sur les colonnes

Si le paramètre <Détails> est à Vrai, la chaîne de caractères contient les noms de toutes les colonnes d'une table avec diverses informations sur ces colonnes (nom, type, taille) sous la forme :
Nom_colonne + TAB + Type 1 (N/T) + TAB + Type 2 (numéro) + TAB + Taille
  • Type 1 (N/T) : "N" colonne de type numérique, "T" colonne de type texte
  • Type 2 : numéro interne indiquant le type exacte de la colonne (voir tableau)
    Type 1Type 2Type ODBC
    N1SQL_BIT : Bit
    N2SQL_TINYINT : Entier
    N3SQL_BIGINT : Entier long
    N4SQL_LONGVARBINARY : Mémo de type binaire
    N5SQL_VARBINARY : Chaîne binaire de taille variable
    N6SQL_BINARY : Binaire
    T7SQL_LONGVARCHAR : Mémo de type chaîne ASCII
    T9SQL_CHAR : Chaîne de taille fixe
    N10SQL_NUMERIC : Numérique
    N11SQL_DECIMAL : Nombre décimal
    N12SQL_INTEGER : Entier
    N13SQL_SMALLINT : Entier
    N14SQL_FLOAT : Réel double
    N15SQL_REAL : Réel simple
    N16SQL_DOUBLE : Réel double
    T17SQL_DATE : Date
    T18SQL_TIME : Heure
    T19SQL_TIMESTAMP : Date heure
    T20SQL_VARCHAR : Chaîne de taille variable
    T0SQL_WCHAR : Chaîne Unicode de taille variable
    T-2SQL_WLONGVARCHAR : Mémo Unicode
  • Taille : Taille affichable de la colonne : pour les chaîne de caractères, taille de la chaîne, et pour les numériques, taille du numérique en octets.
WEBDEV - Code Navigateur En code navigateur :
  • Seuls deux types sont gérés :
    Type 1Type 2Type ODBC
    N16SQL_DOUBLE : Réel double
    T0SQL_WCHAR : Chaîne Unicode de taille variable
  • la taille est vide.
Rappel : Si la requête n'a pas renvoyé de résultat, les caractéristiques des colonnes ne peuvent pas être connues.
WINDEVWEBDEV - Code ServeurEtats et RequêtesJavaPHPAjax

Astuce : Comment accélérer le temps d'exécution de la fonction SQLColonne ?

Il suffit de préfixer le nom de la table par le propriétaire : le résultat sera quasi immédiat :
SQLColonne(NumConnexion, PROPRIETAIRE.CLIENT)
Composante : wd300hf.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 25/05/2022

Signaler une erreur ou faire une suggestion | Aide en ligne locale