Partager via

Objets BLOB et OLE

  • Article

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

Télécharger le pilote OLE DB

OLE DB Driver pour SQL Server expose l’interface ISequentialStream pour prendre en charge l’accès du contrôle serveur consommateur aux types de données SQL Server ntext, text, image, 1, image, varchar(max) , nvarchar(max) , varbinary(max) et xml comme des blobs. La méthode Read sur ISequentialStream permet au consommateur de récupérer un grand nombre de données en blocs maniables.

[1] : L’utilisation de l’interface ISequentialStream pour l’insertion de données encodées en UTF-8 dans une colonne de texte héritée est limitée uniquement aux serveurs qui prennent en charge UTF-8. Si vous tentez d’exécuter ce scénario en ciblant un serveur qui ne prend pas en charge UTF-8, le pilote publiera le message d’erreur suivant : « Diffusion en continu non prise en charge sur le type de colonne sélectionné ».

Pour obtenir un exemple illustrant cette fonctionnalité, consultez Définir des grandes données (OLE DB).

Le pilote OLE DB pour SQL Server peut utiliser une interface IStorage implémentée par le consommateur quand celui-ci fournit le pointeur d’interface dans un accesseur lié pour la modification des données.

Pour les types de données avec des valeurs volumineuses, le pilote OLE DB pour SQL Server vérifie les hypothèses sur la taille du type dans les interfaces IRowset et DDL. Les colonnes avec les types de données varchar, nvarchar et varbinary, et définies avec une taille maximale illimitée, sont représentées en tant que ISLONG dans les ensembles de lignes du schéma et les interfaces qui retournent les types de données des colonnes.

Le pilote OLE DB pour SQL Server expose les types varchar(max) , varbinary(max) et nvarchar(max) respectivement comme DBTYPE_STR, DBTYPE_BYTES et DBTYPE_WSTR.

Pour utiliser ces types, une application dispose des options suivantes :

  • Lier comme type (DBTYPE_STR, DBTYPE_BYTES, DBTYPE_WSTR). Si la mémoire tampon n’est pas assez grande, une troncation est effectuée, exactement comme pour ces types dans les précédentes versions (bien que de plus grandes valeurs soient maintenant disponibles).

  • Lier comme type et spécifier également DBTYPE_BYREF.

  • Lier comme DBTYPE_IUNKNOWN et utiliser la diffusion en continu.

En cas de liaison à DBTYPE_IUNKNOWN, la fonctionnalité de flux ISequentialStream est utilisée. OLE DB Driver pour SQL Server prend en charge la liaison des paramètres de sortie en tant que DBTYPE_IUNKNOWN pour les types de données de valeur élevée. Cela permet de prendre en charge les scénarios dans lesquels une procédure stockée retourne ces types de données comme valeurs de retour, qui seront retournées au client en tant que DBTYPE_IUNKNOWN.

Limitations des objets de stockage

  • OLE DB Driver pour SQL Server ne peut prendre en charge qu'un seul objet de stockage ouvert. Les tentatives d’ouverture de plusieurs objets de stockage (pour obtenir une référence sur plusieurs pointeurs d’interface ISequentialStream) retournent DBSTATUS_E_CANTCREATE.

  • Dans le pilote OLE DB pour SQL Server, la valeur par défaut de la propriété en lecture seule de DBPROP_BLOCKINGSTORAGEOBJECTS est VARIANT_TRUE. Cela signifie que si un objet de stockage est actif, certaines méthodes (autres que celles sur les objets de stockage) échouent avec E_UNEXPECTED.

  • Le pilote OLE DB pour SQL Server doit avoir connaissance de la longueur des données présentées par un objet de stockage implémenté par le consommateur quand l’accesseur de ligne qui référence l’objet de stockage est créé. Le consommateur doit lier un indicateur de longueur dans la structure DBBINDING utilisée pour la création de l'accesseur.

  • Si une ligne contient plusieurs valeurs de données volumineuses et que DBPROP_ACCESSORDER n’est pas DBPROPVAL_AO_RANDOM, le consommateur doit utiliser un ensemble de lignes pris en charge par le curseur du pilote OLE DB pour SQL Server pour extraire les données de ligne ou traiter toutes les valeurs de données volumineuses avant d’extraire d’autres valeurs de ligne. Si DBPROP_ACCESSORDER a pour valeur DBPROPVAL_AO_RANDOM, le pilote OLE DB pour SQL Server met en cache tous les types de données XML comme objets BLOB pour en permettre l’accès dans n’importe quel ordre.

Dans cette section

Voir aussi

Programmation OLE DB Driver pour SQL Server
Utilisation de types de valeur élevée