paramètres Table-Valued (ODBC)

La prise en charge ODBC des paramètres table permet à une application cliente d’envoyer des données paramétrables au serveur plus efficacement, en envoyant plusieurs lignes au serveur avec un seul appel.

Pour plus d’informations sur les paramètres table sur le serveur, consultez Utiliser les paramètres Table-Valued (moteur de base de données).

Dans ODBC, il existe deux façons d’envoyer des paramètres table au serveur :

• Toutes les données de paramètre table peuvent être en mémoire au moment où SQLExecDirect ou SQLExecute est appelée. Ces données sont stockées dans des tableaux s’il existe plusieurs lignes dans la table.

• Une application peut spécifier des données au niveau de l’exécution pour un paramètre table lorsque SQLExecDirect ou SQLExecute est appelé. Dans ce cas, les lignes de données pour la table peuvent être fournies par lots, ou une à la fois pour réduire les besoins en mémoire.

La première option permet aux procédures stockées d’encapsuler davantage de logique métier. Par exemple, une procédure stockée unique peut encapsuler une transaction d’entrée de commande entière lorsque les éléments de commande sont passés en tant que paramètre table. Cette option est très efficace, car un seul aller-retour vers le serveur est requis. Vous pouvez également utiliser différentes procédures pour gérer séparément l’en-tête de commande et les éléments de commande, ce qui nécessiterait davantage de code et un contrat plus complexe entre le client et le serveur.

La deuxième méthode fournit un mécanisme efficace pour les opérations en bloc avec de très grandes quantités de données. Cela permet à une application de diffuser en continu des lignes de données vers le serveur sans avoir à les mettre en mémoire tampon tout d’abord en mémoire.

Vous pouvez créer des contraintes et des clés primaires lorsque vous créez la variable de table. Les contraintes sont un bon moyen de s’assurer que les données d’une table répondent à des exigences spécifiques.

Dans cette section

Utilisations des paramètres de Table-Valued ODBC
Décrit les scénarios d’utilisateur principaux pour les paramètres table et ODBC.

Type SQL ODBC pour les paramètres de Table-Valued
Décrit le type SQL_SS_TABLE. Il s’agit d’un nouveau type ODBC SQL qui prend en charge les paramètres table.

champs de descripteur de paramètreTable-Valued
Décrit les champs de descripteur qui prennent en charge les paramètres table.

Champs de descripteur pour les colonnes constituantes de paramètres Table-Valued
Décrit les champs de descripteur qui ont une signification pour les paramètres table.

champs d’enregistrement de diagnostic de paramètreTable-Valued
Décrit deux champs de diagnostic qui ont été ajoutés aux enregistrements de diagnostic pour prendre en charge les paramètres table.

Attributs d’instruction qui affectent les paramètres de Table-Valued
Décrit un nouveau champ d’en-tête de descripteur qui permet aux colonnes de paramètres table d’être traitées.

Liaison et transfert de données de paramètres et de valeurs de colonne Table-Valued
Décrit la liaison de paramètres et comment passer un paramètre table au serveur.

métadonnées de paramètreTable-Valued pour les instructions préparées
Décrit comment une application peut obtenir des métadonnées pour un appel de procédure préparée.

Métadonnées de paramètres de Table-Valued supplémentaires
Décrit comment utiliser SQLProcedureColumns, SQLTables et SQLColumns pour récupérer les métadonnées d’un paramètre table.

Table-Valued conversion des données des paramètres et autres erreurs et avertissements
Décrit comment traiter les erreurs sur les valeurs de colonne de paramètre table.

Compatibilité entre versions
Décrit les conflits qui peuvent se produire lorsque les paramètres table sont utilisés par un client ou un serveur d’une version antérieure à SQL Server 2008.

Résumé de l’API de paramètre ODBC Table-Valued
Répertorie les fonctions ODBC qui prennent en charge les paramètres table.

Exemples de programmation de paramètres ODBC Table-Valued
Décrit comment effectuer des tâches courantes.

Voir aussi

SQL Server Native Client (ODBC)
paramètresTable-Valued (SQL Server Native Client)