Partager via


Prise en charge des colonnes éparses dans SQL Server Native Client

S’applique à : SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)

Important

SQL Server Native Client (SNAC) n’est pas fourni avec :

  • 2022 - SQL Server 16 (16.x) et versions ultérieures
  • SQL Server Management Studio 19 et versions ultérieures

SQL Server Native Client (SQLNCLI ou SQLNCLI11) et le fournisseur Microsoft OLE DB hérité pour SQL Server (SQLOLEDB) ne sont pas recommandés pour le nouveau développement d’applications.

Pour les nouveaux projets, utilisez l'un des pilotes suivants :

Pour SQLNCLI qui est fourni en tant que composant du moteur de base de données SQL Server (versions 2012 à 2019), consultez cette exception du cycle de vie du support.

SQL Server Native Client prend en charge les colonnes éparses. Pour plus d’informations sur les colonnes éparses dans SQL Server, consultez Utiliser des colonnes éparses et Utiliser des jeux de colonnes.

Pour plus d’informations sur la prise en charge des colonnes éparses dans SQL Server Native Client, consultez Prise en charge des colonnes éparses (ODBC) et Prise en charge des colonnes éparses (OLE DB).

Scénarios utilisateur pour les colonnes éparses et SQL Server Native Client

Le tableau suivant récapitule les scénarios d’utilisateur courants pour les utilisateurs SQL Server Native Client avec des colonnes éparses :

Scénario Comportement
sélectionnez * dans la table ou IOpenRowset::OpenRowset. Retourne toutes les colonnes qui ne sont pas membres du column_set éparses plus une colonne XML qui contient les valeurs de toutes les colonnes non Null qui sont membres du column_set éparses.
Référencer une colonne par nom. La colonne peut être référencée quel que soit l’état de sa colonne éparse ou son appartenance au column_set.
Accédez aux colonnes membres du column_set par le biais d’une colonne XML calculée. Vous pouvez avoir accès aux colonnes qui sont membres du column_set éparses en sélectionnant le column_set par nom. Vous pouvez également insérer et mettre à jour des valeurs dans ces colonnes en mettant à jour le code XML dans la colonne du column_set.

La valeur doit être conforme au schéma pour les colonnes du column_set.
Récupérer les métadonnées de toutes les colonnes d’une table via SQLColumns avec un modèle de recherche de colonne null ou '%' (ODBC) ; ou via l’ensemble de lignes de schéma DBSCHEMA_COLUMNS sans restriction de colonne (OLE DB). Retourne une ligne pour toutes les colonnes qui ne sont pas membres d’un column_set. Si la table possède un column_set éparses, une ligne sera retournée pour ce dernier.

Notez que, dans ce cas, des métadonnées ne sont pas retournées pour les colonnes qui sont membres d’un column_set.
Récupérer des métadonnées pour toutes les colonnes, quel que soit le caractère épars ou l’appartenance à un column_set. De très nombreuses lignes peuvent alors être retournées. Définissez le champ descripteur SQL_SOPT_SS_NAME_SCOPE sur SQL_SS_NAME_SCOPE_EXTENDED et appelez SQLColumns (ODBC).

Appelez IDBSchemaRowset ::GetRowset pour l’ensemble de lignes de schéma DBSCHEMA_COLUMNS_EXTENDED (OLE DB).

Ce scénario n’est pas possible à partir d’une application qui utilise SQL Server Native Client à partir d’une version antérieure à SQL Server 2008 (10.0.x). Toutefois, une telle application peut interroger directement les vues système.
Récupérer des métadonnées uniquement pour les colonnes qui sont membres d’un column_set. De très nombreuses lignes peuvent alors être retournées. Définissez le champ descripteur SQL_SOPT_SS_NAME_SCOPE sur SQL_SS_NAME_SCOPE_SPARSE_COLUMN_SET et appelez SQLColumns (ODBC).

Appelez IDBSchemaRowset ::GetRowset pour l’ensemble de lignes de schéma DBSCHEMA_SPARSE_COLUMN_SET (OLE DB).

Ce scénario n’est pas possible à partir d’une application qui utilise SQL Server Native Client à partir d’une version antérieure à SQL Server 2008 (10.0.x). Toutefois, une telle application offre la possibilité d'interroger les vues système.
Déterminer si une colonne est éparse. Consultez la colonne SS_IS_SPARSE du jeu de résultats SQLColumns (ODBC).

Consultez la colonne SS_IS_SPARSE de l'ensemble de lignes de schéma DBSCHEMA_COLUMNS (OLE DB).

Ce scénario n’est pas possible à partir d’une application qui utilise SQL Server Native Client à partir d’une version antérieure à SQL Server 2008 (10.0.x). Toutefois, une telle application offre la possibilité d'interroger les vues système.
Déterminer si une colonne est un column_set. Consultez la colonne SS_IS_COLUMN_SET du jeu de résultats SQLColumns. Vous pouvez également consulter l’attribut de colonne spécifique à SQL Server SQL_CA_SS_IS_COLUMN_SET (ODBC).

Consultez la colonne SS_IS_COLUMN_SET de l'ensemble de lignes de schéma DBSCHEMA_COLUMNS Ou consultez dwFlags retourné par IColumnsinfo::GetColumnInfo ou DBCOLUMNFLAGS dans l’ensemble de lignes retourné par IColumnsRowset::GetColumnsRowset. Pour column_set colonnes, DBCOLUMNFLAGS_SS_ISCOLUMNSET sera définie (OLE DB).

Ce scénario n’est pas possible à partir d’une application qui utilise SQL Server Native Client à partir d’une version antérieure à SQL Server 2008 (10.0.x). Toutefois, une telle application offre la possibilité d'interroger les vues système.
Importer et exporter des colonnes éparses via BCP pour une table sans column_set. Aucune modification du comportement des versions précédentes de SQL Server Native Client.
Importer et exporter des colonnes éparses via BCP pour une table avec un column_set. column_set est importé et exporté de la même façon que le code XML, c’est-à-dire sous la forme varbinary(max) s’il est lié en tant que type binaire, ou sous la forme nvarchar(max) s’il est lié en tant que type char ou wchar.

Les colonnes qui sont membres du column_set éparses ne sont pas exportées en tant que colonnes distinctes ; elles sont uniquement exportées dans la valeur du column_set.
Comportement de queryout pour BCP. Aucune modification de la gestion des colonnes nommées explicitement à partir des versions précédentes de SQL Server Native Client.

Les scénarios impliquant des opérations d'importation et d'exportation entre les tables avec des schémas différents peuvent nécessiter une gestion spéciale.

Pour plus d'informations sur BCP, consultez la section « Prise en charge de la copie en bloc (BCP) pour les colonnes éparses » plus loin dans cette rubrique.

Comportement de client de bas niveau

Les clients de bas niveau retournent uniquement des métadonnées pour les colonnes qui ne sont pas membres du column_set éparses pour SQLColumns et DBSCHMA_COLUMNS. Les ensembles de lignes de schéma OLE DB supplémentaires introduits dans SQL Server 2008 (10.0.x) Native Client ne seront pas disponibles, ni les modifications apportées à SQLColumns dans ODBC via SQL_SOPT_SS_NAME_SCOPE.

Les clients de bas niveau peuvent accéder par nom aux colonnes membres du column_set éparses et la colonne de column_set sera accessible en tant que colonne XML pour les clients SQL Server 2005 (9.x).

Prise en charge de la copie en bloc (BCP) pour les colonnes éparses

Aucune modification n’est apportée à l’API BCP dans ODBC ou OLE DB pour les colonnes éparses ou les fonctionnalités column_set .

Si une table possède un column_set, les colonnes éparses ne sont pas traitées en tant que colonnes distinctes. Les valeurs de l'ensemble des colonnes éparses sont incluses dans la valeur du column_set qui est exporté de la même manière qu'une colonne XML, à savoir sous la forme varbinary(max) s'il est lié en tant que type binaire ou sous la forme nvarchar(max) s'il est lié en tant que type char ou wchar. Lors de l'importation, la valeur column_set doit être conforme au schéma du column_set.

Dans le cadre des opérations queryout, aucun changement n’intervient dans la manière dont les colonnes explicitement référencées sont gérées. Les colonnes de column_set affichent le même comportement que les colonnes XML et le caractère épars n’a aucune incidence sur la gestion des colonnes éparses nommées.

En revanche, si vous faites appel à queryout pour l’exportation et référencez par nom les colonnes éparses membres du jeu de colonnes éparses, vous ne pouvez procéder à aucune importation directe dans une table de structure identique. Ceci est lié au fait que BCP utilise des métadonnées cohérentes avec une opération select * pour l’importation, et n’est pas en mesure de faire correspondre les colonnes membres de column_set avec ces métadonnées. Pour importer individuellement des colonnes membres de column_set, vous devez définir une vue dans la table qui référence les colonnes de column_set souhaitées, puis procéder à l’opération d’importation à l’aide de la vue.

Voir aussi

Programmation de SQL Server Native Client