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

Précédent | Niveau supérieur | Suivant
SET CONNECTION | Sommaire | TYPE

## SET DESCRIPTOR

SET DESCRIPTOR — positionne des informations dans une zone de descripteur SQL

## Synopsis

    SET DESCRIPTOR nom_descripteur objet_entete_descripteur = valeur [, ... ]
    SET DESCRIPTOR nom_descripteur VALUE numero objet_descripteur = valeur [, ...]

## Description

`SET DESCRIPTOR` remplit une zone de descripteur SQL de valeurs. La zone de descripteur est habituellement utilisée pour lier les paramètres lors d'une exécution de requête préparée

Cette commande a deux formes: la première forme s'applique à l' « entête » du descripteur, qui est indépendant des données spécifiques. La seconde forme assigne des valeurs aux données, identifiées par un numéro.

## Paramètres

`nom_descripteur`

  Un nom de descripteur.

`objet_entete_descripteur`

  Un identifiant pour spécifier quelle information de l'entête est concernée. Seul `COUNT`, qui sert à indiquer le nombre de descripteurs, est supporté pour le moment.

`number`

  Le numéro de l'objet du descripteur à modifier. Le compte commence à 1.

`objet_descripteur`

  Un identifiant spécifiant quelle information du descripteur est concernée. Voyez Section 36.7.1 pour une liste des identifiants supportés.

`valeur`

  Une valeur à stocker dans l'objet descripteur. Cela peut être une constante SQL ou une variable hôte.

## Exemples

    EXEC SQL SET DESCRIPTOR indesc COUNT = 1;
    EXEC SQL SET DESCRIPTOR indesc VALUE 1 DATA = 2;
    EXEC SQL SET DESCRIPTOR indesc VALUE 1 DATA = :val1;
    EXEC SQL SET DESCRIPTOR indesc VALUE 2 INDICATOR = :val1, DATA = 'some string';
    EXEC SQL SET DESCRIPTOR indesc VALUE 2 INDICATOR = :val2null, DATA = :val2;

## Compatibilité

`SET DESCRIPTOR` est spécifié dans le standard SQL.

## Voir aussi

ALLOCATE DESCRIPTOR, GET DESCRIPTOR