Déplacement des données dans des variables de programme
Les applications ayant accès aux bases de données SQL Server 2005 via une API de base de données doivent déplacer des données entre les variables d'application et les éléments suivants :
- Colonnes d'ensembles de résultats
Les applications doivent déplacer les données des colonnes d'une ligne extraite d'un ensemble de résultats dans des variables d'application. - Codes de retour
Les applications doivent déplacer les données d'un code de retour de procédure stockée dans une variable d'application. - Paramètres
Les applications doivent déplacer les données entre des paramètres de procédures et des variables d'application. Il peut s'agir de paramètres d'entrée ou de paramètres de sortie. Par conséquent, le déplacement des données peut s'opérer à partir des variables vers les paramètres ou à partir des paramètres vers les variables. - Marqueurs de paramètres
Les marqueurs de paramètre ODBC et OLE DB sont utilisés dans les instructions SQL à la place d'une expression d'entrée (comme dans la condition de recherche de la clause WHERE) ou à la place des paramètres ou des codes de retour des procédures stockées. Les applications doivent déplacer des données de variables d'application et de l'expression remplacée par le marqueur de paramètre. Pour plus d'informations, consultez Marqueurs de paramètres (moteur de base de données).
Liaisons
De nombreuses API de bases de données utilisent le concept de liaison pour indiquer la manière de déplacer les données entre une variable d'application et l'objet SQL Server. Les API de bases de données fournissent des fonctions qu'une application peut appeler pour effectuer les opérations suivantes :
- déterminer le type de données, la précision et l'échelle de la colonne de résultat, du code de retour, du paramètre et du marqueur de paramètre. Après la réception de ces informations, l'application peut allouer une variable ou un ensemble de variables avec des attributs compatibles ;
- lier la colonne de l'ensemble de résultats, le code de retour, le paramètre ou le marqueur de paramètre à une variable ou un ensemble de variables spécifiques. Les informations de liaison comprennent généralement les éléments suivants :
- l'adresse et les attributs (type de données, taille, précision et échelle) de la variable ;
- le nom et les attributs de l'objet de la base de données.
En principe, les données sont déplacées lorsque l'une des actions suivantes intervient :
- Un lot ou une instruction Transact-SQL est exécuté.
Le fournisseur OLE DB ou le pilote ODBC extrait les données liées à un paramètre d'entrée ou à un marqueur de paramètre, puis inclut celles-ci dans le paquet envoyé à l'instance de SQL Server. - Une ligne d'un ensemble de résultats est extraite.
Le fournisseur OLE DB ou le pilote ODBC déplace les données pour chaque colonne dans les variables liées. - Tous les ensembles de résultats d'une procédure stockée ont été extraits ou annulés.
Le fournisseur OLE DB ou le pilote ODBC déplace les données de tous les paramètres de sortie ou codes de retour dans leurs variables liées.
Les variables d'application liées ne doivent pas nécessairement disposer du même type de données que l'objet SQL Server auquel elles sont liées. Si les types de données sont différents, le fournisseur OLE DB ou le pilote ODBC convertit les données lorsqu'elles sont déplacées. Le jeu de conversions accepté par chaque fournisseur OLE DB et pilote ODBC est précisé dans la documentation du fournisseur ou du pilote.
Voir aussi
Concepts
Marqueurs de paramètres (moteur de base de données)
Utilisation de variables et de paramètres (moteur de base de données)