OLEDB存取BLOB型数据

zoukankan html css js c++ java

OLEDB存取BLOB型数据
现代数据库系统除了支持一些标准的通用数据类型以外，大多数还支持一种称之为BLOB型的数据。
BLOB全称为big large object bytes, 大二进制对象类型，这种类型的数据通常用于存储文档、图片、音频等文件，这些文件一般体积较大，保存这些文件可以很方便的管理和检索这类信息。在MS SQLSERVER中常见的BLOB数据类型有text、ntext(n表示unicode)、image、nvarchar、varchar、varbinary等。其中image基本可以用来保存一切二进制文件，比如word、Excel、音频、视频等等类型。
针对BLOB型数据，OLEDB也提供了对它的支持

使用BLOB型数据的利弊

一般数据库对BLOB型数据有特殊的处理方式，比如压缩等等，在数据库中存储BLOB数据可以方便的进行检索，展示，备份等操作。但是由于BLOB型数据本身比较大，存储量太大时数据量太大容易拖慢数据库性能，所以一般的说法都是尽量不要在数据库中存储这类信息。特别是图片，音视频。针对这类文件一般的做法是将其保存在系统的某个路径钟中，而在数据库中存储对应的路径

操作BLOB型数据的一般方法

一般针对BLOB不能像普通数据那样操作，而需要一些特殊的操作，在OLEDB中通过设置绑定结构中的一些特殊值最终指定获取BLOB型数据的一个ISequentialStream接口指针,最终会通过这个接口来进行BLOB型数据的读写操作

判断一个列是否是BLOB型数据

判断某个列是否是BLOB型数据一般通过如下两个条件：
1. pColumnInfo[i].wType == DBTYPE_IUNKNOW ：包含当列信息的DBCOLUMNSINFO 结构体对象的wType值为DBTYPE_IUNKNOW，该列的类型为DBTYPE_IUNKNOW，该条件也被称为列类型判定
2. pColumnInfo[i].dwFlags & DBCOLUMNFLAGS_ISLONG ：当列信息中的dwFlag值为DBCOLUMNFLAGS_ISLONG,也就是说该列的标识中包含DBCOLUMNFLAGS_ISLONG属性，该判定条件也被称之为列标识判定
  当这两个条件之一成立之时，我们就可以断定这列为BLOB型数据
BLOG型数据的绑定

在进行BLOB型数据的绑定也有特殊要求，主要体现在下面几点：
1. 绑定结构的cbMaxLength 需要设置为0
2. 绑定结构的wType设置为DBTYPE_IUNKNOW
3. 为结构的pObject指针分配内存，大小等于DBOBJECT结构的大小
4. 指定pObject的成员
  pObject->iid = IID_ISequentialStream
  pObject->dwFlags = STGM_READ
5. 为行缓冲长度加上一个IStream指针的长度，此时数据源不再提供查询到的数据而提供一个接口指针，后续对BLOB数据的操作都使用该指针进行
  最后使用完后记得释放pObject所指向的内存空间
读取BLOB数据

根据前面所说的创建绑定结构，并为绑定结构赋值，最终可以从结果集中获取到一个ISequentialStream接口指针。调用接口的Read方法可以读取到BLOB列中的数据，而BLOB数据的长度存储在绑定时指定的数据长度内存偏移处,这与普通列的长度存放返回方式是一样的，一般BLOB数据都比较长，这个时候就需要分段读取。
在使用ISequentialStream接口操作BLOB型数据时需要注意的一个问题是，有的数据库不支持在一个访问器中访问多个BLOB数据列。一般BLOB数据列及其的消耗资源，并且数据库鼓励我们在设计数据库表结构的时候做到一行只有一列BLOB数据，因此很多数据库并不支持在一个访问器中读取多个BLOB数据。
要判断数据库是否支持在一个访问器中读取多个BLOB数据，可以获取DBPROP_MULTIPLESTORAGEOBJECTS属性，该属性属于属性集DBPROPSET_ROWSET，它是一个只读属性，如果该属性的值为TRUE表示支持，为FALSE表示不支持。
下面是一个读取BLOB型数据的例子,数据库中的表结构为：id(int)、text(image)、png(image)、jpg(image)
```
void ReadBLOB(IRowset *pIRowset)
{
	COM_DECLARE_INTERFACE(IColumnsInfo);
	COM_DECLARE_INTERFACE(IAccessor);

	DBORDINAL cColumns = 0;
	DBCOLUMNINFO* rgColumnsInfo = NULL;
	LPOLESTR lpszColumnsName = NULL;
	DBBINDING* rgBindings = NULL;
	DBBINDING** ppBindings = NULL; //绑定结构数组
	DWORD *puDataLen = NULL; //当前访问器所需内存大小
	DWORD *pulColCnt = NULL; //当前访问器中包含的项
	ULONG ulBindCnt = 0; //访问器的数量
	ULONG uBlob = 0; //当前有多少blob数据
	HACCESSOR* phAccessor = NULL;
	HROW* hRow = NULL;
	DBCOUNTITEM ulGetRows = 0;
	ULONG uCols = 0;

	PVOID pData1 = NULL; //第1个访问器中数据的缓冲
	PVOID pData2 = NULL; //第2个访问器中数据的缓冲
	PVOID pData3 = NULL; //第3个访问器中数据的缓冲

	HRESULT hRes = pIRowset->QueryInterface(IID_IColumnsInfo, (void**)&pIColumnsInfo);
	COM_SUCCESS(hRes, _T("查询接口pIColumnsInfo失败，错误码为:%08x
"), hRes);
	hRes = pIColumnsInfo->GetColumnInfo(&cColumns, &rgColumnsInfo, &lpszColumnsName);
	COM_SUCCESS(hRes, _T("获取结果集列信息失败，错误码为:%08x
"), hRes);

	ppBindings = (DBBINDING**)COM_ALLOC(sizeof(DBBINDING*));
	rgBindings = (DBBINDING*)COM_ALLOC(sizeof(DBBINDING) * cColumns);
	pulColCnt = (DWORD*)COM_ALLOC(sizeof(DWORD));
	puDataLen =  (DWORD*)COM_ALLOC(sizeof(DWORD));
	for (int i = 0; i < cColumns; i++)
	{
    //如果当前访问器对应的绑定结构的数组的首地址为空，将当前绑定结构指针作为绑定结构数组的首地址
		if (NULL == ppBindings[ulBindCnt])
		{
			ppBindings[ulBindCnt] = &rgBindings[i];
		}

		++pulColCnt[ulBindCnt];
		rgBindings[i].bPrecision = rgColumnsInfo[i].bPrecision;
		rgBindings[i].bScale = rgBindings[i].bScale;
		rgBindings[i].cbMaxLen = 10 * sizeof(WCHAR);
		rgBindings[i].dwMemOwner = DBMEMOWNER_CLIENTOWNED;
		rgBindings[i].dwPart = DBPART_LENGTH | DBPART_STATUS | DBPART_VALUE;
		rgBindings[i].eParamIO = DBPARAMIO_NOTPARAM;
		rgBindings[i].iOrdinal = rgColumnsInfo[i].iOrdinal;
		rgBindings[i].obStatus = puDataLen[ulBindCnt];
		rgBindings[i].obLength = puDataLen[ulBindCnt] + sizeof(DBSTATUS);
		rgBindings[i].obValue = rgBindings[i].obLength + sizeof(ULONG);
		rgBindings[i].wType = DBTYPE_WSTR;

		if (rgColumnsInfo[i].wType == DBTYPE_IUNKNOWN ||
			rgColumnsInfo[i].dwFlags & DBCOLUMNFLAGS_ISLONG)
		{
			rgBindings[i].cbMaxLen = 0;
			rgBindings[i].wType = DBTYPE_IUNKNOWN;
			rgBindings[i].pObject = (DBOBJECT*)COM_ALLOC(sizeof(DBOBJECT));
			rgBindings[i].pObject->iid = IID_ISequentialStream;
			rgBindings[i].pObject->dwFlags = STGM_READ;
			uBlob++;
		}

		//记录下每个访问器所需内存的大小
		puDataLen[ulBindCnt] = rgBindings[i].obValue + rgBindings[i].cbMaxLen;
		if (rgBindings[i].wType == DBTYPE_IUNKNOWN)
		{
			puDataLen[ulBindCnt] = rgBindings[i].obValue + sizeof(ISequentialStream*);
		}

		puDataLen[ulBindCnt] = UPGROUND(puDataLen[ulBindCnt]);
		//判断当前是否需要创建单独的访问器
		if ((uBlob || rgBindings[i].iOrdinal == 0))
		{
			ulBindCnt++;
			ppBindings = (DBBINDING**)COM_REALLOC(ppBindings, sizeof(DBBINDING*) * (ulBindCnt + 1));
			puDataLen = (DWORD*)COM_REALLOC(puDataLen, sizeof(DWORD) * (ulBindCnt + 1));
			pulColCnt = (DWORD*)COM_REALLOC(pulColCnt, sizeof(DWORD) * (ulBindCnt + 1));
		}
	}

	//创建访问器
	phAccessor = (HACCESSOR*)COM_ALLOC( (ulBindCnt + 1) * sizeof(HACCESSOR));
	hRes = pIRowset->QueryInterface(IID_IAccessor, (void**)&pIAccessor);
	COM_SUCCESS(hRes, _T("查询IAccessor接口失败，错误码为:%08x
"), hRes);
	for (int i = 0; i < ulBindCnt; i++)
	{
		hRes = pIAccessor->CreateAccessor(DBACCESSOR_ROWDATA, pulColCnt[i], ppBindings[i], 0, &phAccessor[i], NULL);
		COM_SUCCESS(hRes, _T("创建访问器失败，错误码为:%08x
"), hRes);
	}

	//读取其中的一行数据
	hRes = pIRowset->GetNextRows(DB_NULL_HCHAPTER, 0, 1, &ulGetRows, &hRow);
	COM_SUCCESS(hRes, _T("读取行数据失败，错误码为:%08x
"), hRes);

	//读取第一个绑定结构中的信息
	pData1 = COM_ALLOC(puDataLen[0]);
	hRes = pIRowset->GetData(hRow[0], phAccessor[0], pData1);
	for(int i = 0; i < pulColCnt[0]; i++)
	{
		if (ppBindings[0][i].wType == DBTYPE_IUNKNOWN)
		{
			DBSTATUS dbStatus = *(DBSTATUS*)((BYTE*)pData1 + ppBindings[0][i].obStatus);
			if (dbStatus == DBSTATUS_S_OK)
			{
				ULONG uFileLen = *(ULONG*)((BYTE*)pData1 + ppBindings[0][i].obLength);
				if (uFileLen > 0)
				{
					DWORD dwReaded = 0;
					PVOID pFileData = COM_ALLOC(uFileLen);
					ZeroMemory(pFileData, uFileLen);
					ISequentialStream  *pSeqStream = *(ISequentialStream**)((BYTE*)pData1 + ppBindings[0][i].obValue);
					pSeqStream->Read(pFileData, uFileLen, &dwReaded);

					WriteFileData(_T("1.txt"), pFileData, dwReaded);
				}
			}
		}
	}

	//后续的部分就不再写出来了,写法与上面的代码类似
	pIRowset->ReleaseRows(1, hRow, NULL, NULL, NULL);
__CLEAR_UP:
  //后面是清理的代码
```
由于我们事先知道数据表的结构，它有3个BLOB型数据，所以这里直接定义了3个缓冲用来接收3个BLOB型数据。为了方便检测，我们另外写了一个的函数，将读取出来的BLOB数据写入到文件中，事后以文件显示是否正确来测试这段代码
首先还是与以前一样，获取数据表的结构，然后进行绑定，注意这里由于使用的是SQL Server，它不支持一个访问器中访问多个BLOB，所以这里没有判断直接绑定不同的访问器。
在绑定的时候使用ulBindCnt作为当前访问器的数量，在循环里面有一个判断当(uBlob || rgBindings[i].iOrdinal == 0) && (ulBindCnt != cColumns - 1)条件成立时将访问器的数量加1，该条件表示之前已经有blob型数据（之前SQL不支持一个访问器访问多个BLOB，如果之前已经有BLOB数据了，就需要另外创建访问器）或者当前是第0行（因为第0行只允许读，所以将其作为与BLOB型数据一样处理），当这些条件成立时会新增一个访问器，而随着访问器的增加，需要改变ppBindings数组中的元素，该数组存储的是访问器对应的绑定结构开始的指针。数组puDataLen表示的是当前访问器所需内存的大小，pulColCnt表示当前访问器中共有多少列，针对这个表最终这些结构的内容大致如下图：

绑定完成之后，后面就是根据数组中的内容创建对应的访问器，然后绑定、读取数据，针对BLOB数据，我们还是一样从对应缓冲的obValue偏移处得到接口指针，然后调用接口的Read方法读取，最后写入文件

BLOB数据的写入:

要写入BLOB型数据也需要使用ISequentialStream接口,但是它不像之前可以直接使用接口的Write方法，写入的对象必须要自己从ISequentialStream接口派生，并指定一段内存作为缓冲，以便供OLEDB组件调用写方法时作为数据缓冲。这段缓冲必须要保证分配在COM堆上，也就是要使用CoTaskMemory分配内存。
这里涉及到的对象主要有IStream、ISequentialStream、IStorage、ILockBytes，同样，并不是所有数据源都支持这4类对象，具体支持哪些可以查询DBPROPSET_DATASOURCEINFO属性集中的DBPROP_STRUCTUREDSTORAGE属性来判定，目前SQL Server中支持ISequentialStream接口。
虽然我们可以使用这种方式来实现读写BLOB，但是每种数据源支持的程度不同，而且有的数据源甚至不支持这种方式，为了查询对读写BLOB数据支持到何种程度，可以查询DBPROPSET_DATASOURCEINFO属性集合的DBPROP_OLEOBJECTS属性来判定
通常有以下几种支持方式(DBPROP_OLEOBJECTS属性的值,按位设置):
1. DBPROPVAL_OO_BLOB: 就是之前介绍的接口方式，使用接口的方式来读写BLOB数据
  DBPROPVAL_OO_DIRECTBIND: 可以直接绑定在行中,通过行访问器像普通列一样访问，也就是说它不需要获取专门的指针来操作，他可以就像操作普通数据那样，分配对应内存就可以访问，但是要注意分配内存的大小，每行中对应列中BLOB的数据长度差别可能会很明显，比如有的可能是一部长达2小时的电影文件，而有的可能是一部短视频，它们之间的差距可能会达到上G，而按照最小的来可能会发生截断，按最大的分配可能会发生多达好几个G的内存浪费
  DBPROPVAL_OO_IPERSIST:通过IPersistStream, IPersistStreamInit, or IPersistStorage三个接口的Persist对象访问
  DBPROPVAL_OO_ROWOBJECT: 支持整行作为一个对象来访问,通过结果集对象的IGetRow接口来获得行对象，但是这种模式会破坏第三范式，所以一般数据库都不支持
  DBPROPVAL_OO_SCOPED: 通过IScopedOperations接口来暴露行对象,通过这个接口可以暴露一个树形的结果集对象
  DBPROPVAL_OO_SINGLETON: 直接通过ICommand::Execute和IOpenRowset::OpenRowset来打开行对象
  下面是插入BLOB数据的一个实例
```
//自定义一个
class CSeqStream : public ISequentialStream
{
public:
	// Constructors
	CSeqStream();
	virtual ~CSeqStream();
public:
	virtual BOOL Seek(ULONG iPos); //将当前内存指针偏移到指定位置
	virtual BOOL CompareData(void* pBuffer); //比较两段内存中的值
	virtual ULONG Length()
	{
		return m_cBufSize;
	};
	virtual operator void* const()
	{
		return m_pBuffer;
	};
public:
	STDMETHODIMP_(ULONG) AddRef(void);
	STDMETHODIMP_(ULONG) Release(void);
	STDMETHODIMP QueryInterface(REFIID riid, LPVOID *ppv);

  //读写内存的操作，这些是必须实现的函数
	STDMETHODIMP Read(
		/* [out] */ void __RPC_FAR *pv,
		/* [in]  */ ULONG cb,
		/* [out] */ ULONG __RPC_FAR *pcbRead);

	STDMETHODIMP Write(
		/* [in] */ const void __RPC_FAR *pv,
		/* [in] */ ULONG cb,
		/* [out]*/ ULONG __RPC_FAR *pcbWritten);
private:
	ULONG m_cRef;       // reference count
	void* m_pBuffer;    // buffer
	ULONG m_cBufSize;   // buffer size
	ULONG m_iPos;       // current index position in the buffer
};
```
```
//插入数据第一列BLOB数据
	//这里由于已经事先知道每列的数据结构，因此采用偷懒的方法，一行行的插入
	pData1 = HeapAlloc(GetProcessHeap(), HEAP_ZERO_MEMORY, pdwDataLen[nCol]);
	for(int i = 0; i < pulColCnt[nCol]; i++)
	{
		if (DBTYPE_IUNKNOWN == ppBindings[nCol][i].wType)
		{
			*(DBSTATUS*)((BYTE*)pData1 + ppBindings[nCol][i].obStatus) = DBSTATUS_S_OK;
			CSeqStream *pSeqStream = new CSeqStream();
			GetFileData(_T("test.txt"), dwFileLen, pFileData);
			pSeqStream->Write(pFileData, dwFileLen, &dwWritten);
			pSeqStream->Seek(0); //写这个操作将缓存的指针偏移到了最后，需要调整一下，以便OLEDB组件在插入BLOB数据时从缓存中读取
			HeapFree(GetProcessHeap(), 0, pFileData);
			*(ULONG*)((BYTE*)pData1 + ppBindings[nCol][i].obLength) = dwFileLen;
			*(ISequentialStream**)((BYTE*)pData1 + ppBindings[nCol][i].obValue) = pSeqStream;
			//此处不用release pSeqStream，COM组件会自动释放
		}else
		{
			//根据数据库定义，此处应该为ID
			*(ULONG*)((BYTE*)pData1 + ppBindings[nCol][i].obLength) = 10;
			if (DBTYPE_WSTR == ppBindings[nCol][i].wType)
			{
				StringCchCopy((LPOLESTR)((BYTE*)pData1 + ppBindings[nCol][i].obValue), 10, SysAllocString(OLESTR("1")));
			}
		}
	}

	hRes = pIRowsetChange->InsertRow(DB_NULL_HCHAPTER, phAccessor[nCol], pData1, &hNewRow);
	COM_SUCCESS(hRes, _T("插入第1列BLOB数据失败，错误码为:%08x
"), hRes);
```
在上面的代码中首先定义一个派生类，用来进行BLOB数据的读写，然后在后面的代码中演示了如何使用它
在后面的一段代码中，基本步骤和之前一样，经过连接数据源、创建回话对象，打开表，然后绑定，获取行访问器，这里由于代码基本不变，为了节约篇幅所以省略它们，只贴出最重要的部分。
在插入的代码中，首先查找访问器中的各个列的属性，如果是BLOB数据就采用BLOB数据的插入办法，否则用一般数据的插入办法。插入BLOB数据时，首先创建一个派生类的对象，注意此处由于后续要交给OLEDB组件调用，所以不能用栈内存。我们先调用类的Write方法将内存写入对应的缓冲中，然后调用Seek函数将内存指针偏移到缓冲的首地址，这个指针的作用就相当于文件的文件指针，COM组件在调用对应函数将它插入数据库时会采用这个内存的指针，所以必须将其置到首地址处。让后将对象的指针放入到对应的obvalues偏移中，设置对应的数据大小为BLOB数据的大小，最后只要像普通数据类型那样调用对应的更新方法即可实现BLOB数据的插入

最后贴上两个例子的详细代码地址
示例1:BLOB数据的读取
 示例2:BLOB数据的插入
查看全文

相关阅读:
【C++11】准备：gcc 4.9.0编译安装
 【转】C++ 虚函数表解析
 【工作总结】内存泄漏总结
 【工作总结】C++ string工具类
 工作总结
 【工作笔记】CxImage简介
 【工作笔记】没有界面程序调用ActiveX控件
 【工作笔记】npapi插件编写
 【工作笔记】VLC播放器在chrome中的调用
 Linux多任务编程之三：exec函数族及其基础实验（转）

原文地址：https://www.cnblogs.com/lanuage/p/8894242.html

OLEDB存取BLOB型数据

使用BLOB型数据的利弊

操作BLOB型数据的一般方法

判断一个列是否是BLOB型数据

BLOG型数据的绑定

读取BLOB数据

BLOB数据的写入: