Documentation PostgreSQL 14.22 » Interfaces client » ECPG -- SQL embarqué en C » Commandes SQL Embarquées » DESCRIBE

Précédent | Niveau supérieur | Suivant
DECLARE STATEMENT | Sommaire | DISCONNECT

## DESCRIBE

DESCRIBE — obtient des informations à propos d'une requête préparée ou d'un jeu de résultat

## Synopsis

    DESCRIBE [ OUTPUT ] nom_prepare USING [ SQL ] DESCRIPTOR nom_descripteur
    DESCRIBE [ OUTPUT ] nom_prepare INTO [ SQL ] DESCRIPTOR nom_descripteur
    DESCRIBE [ OUTPUT ] nom_prepare INTO nom_sqlda

## Description

`DESCRIBE` récupère des informations sur les métadonnées à propos des colonnes de résultat contenues dans une requête préparée, sans déclencher la récupération d'un enregistrement.

## Paramètres

`nom_prepare`

  Le nom d'une requête préparée. Cela peut être un identifiant SQL ou une variable hôte.

`nom_descripteur`

  Un nom de descripteur. Il est sensible à la casse. Cela peut être un identifiant SQL ou une variable hôte.

`nom_sqlda`

  Le nom d'une variable SQLDA.

## Exemples

    EXEC SQL ALLOCATE DESCRIPTOR mydesc;
    EXEC SQL PREPARE stmt1 FROM :sql_stmt;
    EXEC SQL DESCRIBE stmt1 INTO SQL DESCRIPTOR mydesc;
    EXEC SQL GET DESCRIPTOR mydesc VALUE 1 :charvar = NAME;
    EXEC SQL DEALLOCATE DESCRIPTOR mydesc;

## Compatibilité

`DESCRIBE` est spécifié dans le standard SQL.

## Voir aussi

ALLOCATE DESCRIPTOR, GET DESCRIPTOR