ColonnesTablesSql

Instruction attribut. Exécution d'une requête énumérant la liste des colonnes d'une table.

Syntaxe

ColonnesTablesSql ConnexionSql Expression

Description

L'instruction attribut ColonnesTablesSql permet d'exécuter une requête interrogeant le dictionnaire de données et de traitements concernant les colonnes d'une table.

Les paramètres de la requête Sql sont les suivants :

Nom du paramètreType du paramètreDescription du paramètre
NomProprietaireCaractereNom du propriétaire de la table.
NomCatalogueCaractereNom du catalogue de la table.
NomSchemaCaractereNom du schéma de la table.
NomTableCaractereNom de la table.
NomColonneCaractereNom de la colonne.

Si le nom du propriétaire est précisé dans le paramète NomProprietaire, alors seules les colonnes des tables de ce propriétaire sont remontées.
La fin du nom du propriétaire peut être le caractère joker *. En ce cas, toutes les colonnes des tables des propriétaires dont le nom correspond au modèle sont examinés.

Si le nom du catalogue est précisé dans le paramète NomCatalogue, alors seules les tables, les vues ou les synonymes de ce catalogue sont remontés.
La fin du nom du catalogue peut être le caractère joker *. En ce cas, tous les catalogues dont le nom correspond au modèle sont examinés.

Si le nom du schéma est précisé dans le paramète NomSchema, alors seules les tables, les vues ou les synonymes de ce schéma sont remontés.
La fin du nom du schéma peut être le caractère joker *. En ce cas, tous les schémas dont le nom correspond au modèle sont examinés.

Si le nom de la table est précisé dans le paramète NomTable, alors les tables, vues ou synonymes ci-dénommés sont remontés.
La fin du nom de la table peut être le caractère joker *. En ce cas, toutes les tables, les vues, les synonymes dont le nom correspond au modèle sont examinés.

Si le nom de la colonne est précisé dans le paramète NomColonne, alors la colonne ci-dénommée est remontée.
La fin du nom de la colonne peut être le caractère joker *. En ce cas, toutes les colonnes dont le nom correspond au modèle sont examinées.

Les résultats de la requête Sql sont les suivants :

Nom du résultatType du résultatDescription du résultat
NomProprietaireCaractereNom du propriétaire.
NomCatalogueCaractereNom du catalogue.
NomSchemaCaractereNom du schéma.
NomTableCaractereNom de la table, de la vue ou du synonyme.
NomColonneCaractereNom de la colonne.
TypeColonneSorteDonneesSupporteesType de la colonne.
TailleColonneEntierTaille de la colonne.
EstNulBooleenSi Vrai, une valeur de la colonne peut être Nul.
CommentaireCaractereCommentaire associé à la colonne.

Les instructions du corps de la requête Sql sont exécutées en boucle pour chaque enregistrement produit. Il est possible de passer à l'enregistrement suivant par l'emploi de l'instruction Continuer. Il est possible d'interrompre cette boucle par l'emploi de l'instruction Arreter.

Pour connaître le numéro de l'enregistrement courant, il faut employer l'instruction NumeroEnregistrementSql. Pour connaître le nombre d'enregistrements produit, il faut employer l'instruction NbEnregistrementSql.

Une requête Sql est un objet implicite d'un type implémentant l'interface IRequeteSql. Le type est automatiquement déduit de la connexion associée à la requête Sql.

Pour connaître les propriétés et les méthodes de ce type, veuillez vous reporter à la fiche Description de l'interface IRequeteSql.

Exemple

Variable
/******/

ConnexionSql
/*******/

Principal
/*******/
...
RequeteSql MaRequeteSql Catalogues ConnexionSql MaConnexionSql Fin RequeteSql
...
Fin Principal

Voir aussi

ParametreSql pour déclarer les paramètres d'une requête Sql. ResultatSql pour déclarer les résultats d'une requête Sql.
CataloguesSql pour énumérer les catalogues. ClesEtrangeresSql pour énumérer les clés étrangères. ClesPrimairesSql pour énumérer les clés primaires. IndexSql pour énumérer les index. ParametresProceduresSql pour énumérer les paramètres des procédures ou des fonction stockées. ProceduresSql pour énumérer les procédures ou des les fonctions stockées. SchemasSql pour énumérer les schémas. TablesSql pour énumérer les tables.

Traduction

---------