Paramètres table (ODBC)

  • Article

S’applique à :SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)

La prise en charge des paramètres table par ODBC permet à une application cliente d'envoyer plus efficacement des données paramétrables au serveur par l'envoi de plusieurs lignes au serveur en un seul appel.

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

Dans ODBC, vous pouvez envoyer des paramètres table au serveur de deux manières :

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

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

La première option permet aux procédures stockées de renfermer une logique métier plus importante. Par exemple, une même procédure stockée peut encapsuler une transaction d'enregistrement de commande entière lorsque les éléments de la commande sont passés sous la forme de paramètre table. Cette option est très efficace, car un seul aller-retour sur 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 seconde méthode propose un mécanisme efficace pour les opérations en bloc portant sur de grandes quantités de données. Une application peut en effet transmettre en continu des lignes de données au serveur sans devoir commencer par toutes les mettre en mémoire tampon.

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 veiller à ce que les données d'une table répondent à des spécifications particulières.

Dans cette section

Scénarios d'utilisation des paramètres table ODBC
Décrit les principaux scénarios utilisateur pour les paramètres table et ODBC.

Type ODBC SQL pour les paramètres table
Décrit le type SQL_SS_TABLE. ll s'agit d'un nouveau type SQL ODBC qui prend en charge les paramètres table.

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

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

Champs d’enregistrement de diagnostic de paramètres table
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 des paramètres table
Décrit un nouveau champ d'en-tête de descripteur qui permet aux colonnes de paramètres table d'être adressés.

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

Métadonnées de paramètres table 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é.

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

Conversion des données des paramètres table, et autres erreurs et avertissements
Décrit comment traiter les erreurs sur les valeurs de colonne de paramètre table.

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

Récapitulatif des API de paramètre table ODBC
Répertorie les fonctions ODBC qui prennent en charge les paramètres table.

Voir aussi

SQL Server Native Client (ODBC)
Paramètres table (SQL Server Native Client)