Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Les champs de descripteur de paramètre table décrits dans cette section sont manipulés à l’aide de SQLSetDescField et DE SQLSetDescField avec le handle du descripteur de paramètre d’implémentation (IPD).
Remarques
SQL_DESC_AUTO_UNIQUE_VALUE est utilisé pour les paramètres table ainsi que d’autres fonctionnalités.
| Nom de l’attribut | Catégorie | Descriptif |
|---|---|---|
| SQL_DESC_AUTO_UNIQUE_VALUE | SQLINTEGER | SQL_TRUE indique que cette colonne est une colonne d’identité. SQL Server peut utiliser ces informations pour optimiser les performances, mais les applications ne sont pas requises pour les définir pour les colonnes d’identité. |
Les attributs suivants sont ajoutés à tous les types de paramètres dans le descripteur de paramètre d’application (APD) et le descripteur de paramètre d’implémentation (IPD) :
| Nom de l’attribut | Catégorie | Descriptif |
|---|---|---|
| SQL_CA_SS_COLUMN_COMPUTED | SQLSMALLINT | SQL_TRUE indique que cette colonne est calculée. SQL Server peut utiliser ces informations pour optimiser les performances, mais les applications ne sont pas requises pour la définir pour les colonnes calculées. Cet attribut est ignoré pour les liaisons qui ne sont pas des colonnes de paramètres table. |
| SQL_CA_SS_COLUMN_IN_UNIQUE_KEY | SQLSMALLINT | SQL_TRUE indique qu’une colonne de paramètre table participe à une clé unique. Cela peut entraîner de meilleures performances de requête. Cet attribut est ignoré pour les liaisons qui ne sont pas des colonnes de paramètres table. |
| SQL_CA_SS_COLUMN_SORT_ORDER | SQLSMALLINT | Indique l’ordre de tri d’une colonne de paramètre table. Cela peut entraîner de meilleures performances de requête. Cet attribut est ignoré pour les liaisons qui ne sont pas des colonnes de paramètres table. Les valeurs possibles sont les suivantes : - SQL_SS_ASCENDING_ORDER - SQL_SS_DESCENDING_ORDER - SQL_SS_ORDER_UNSPECIFIED Les valeurs autres que SQL_SS_ASCENDING_ORDER et SQL_SS_DESCENDING_ORDER génèrent une erreur avec SQLSTATE HY024 et le message « Valeur d’attribut non valide » et sont traitées comme SQL_SS_ORDER_UNSPECIFIED, qui est la valeur par défaut de cet attribut. |
| SQL_CA_SS_COLUMN_SORT_ORDINAL | SQLSMALLINT | Indique l’ordinal d’une colonne de paramètre table dans l’ensemble de colonnes qui définissent l’ordre global d’un paramètre table. Cela peut entraîner de meilleures performances de requête. Cet attribut est ignoré pour les liaisons qui ne sont pas des colonnes de paramètres table. Les ordinals de tri commencent à 1. La valeur 0, la valeur par défaut, indique qu’une colonne de paramètre table n’a pas d’ordre de colonne. |
| SQL_CA_SS_COLUMN_HAS_DEFAULT_VALUE | SQLSMALLINT | Indique si toutes les lignes du paramètre table auront la valeur par défaut pour cette colonne. Pour les paramètres table, il n’est pas possible de sélectionner la valeur par défaut sur une base ligne par ligne. Une valeur de SQL_FALSE indique que les lignes auront des valeurs non par défaut. Il s’agit de la valeur par défaut. Une valeur de SQL_TRUE indique que cette colonne aura des valeurs par défaut pour toutes les lignes. Si la valeur est définie sur SQL_TRUE, aucune donnée n’est envoyée au serveur. Ce champ peut également être utilisé avec des colonnes d’identité ou calculées si les valeurs de colonne ne sont pas requises pour le traitement du serveur. |
Ces attributs sont valides uniquement pour les colonnes de paramètres table. Ils sont ignorés pour d’autres paramètres.
Si SQL_CA_SS_COL_HAS_DEFAULT_VALUE est défini pour une colonne de paramètre table, SQL_DESC_DATA_PTR pour cette colonne doit être un pointeur Null. Sinon, SQLExecute ou SQLExecDirect retourne SQL_ERROR. Un enregistrement de diagnostic est généré avec SQLSTATE=07S01 et le message « Utilisation non valide du paramètre par défaut pour le paramètre <p>, colonne <c> », où <p> est l’ordinal du paramètre et <c> est l’ordinal de colonne.