char m_paramName[50];
int m_paramCount;
void BindParameters(HSTMT);
};
void CMyDatabase::BindParameters(HSTMT hStmt) {
SQLBindParameter( // Связываем @paramName с m_paramName
hStmt, 1, SQL_PARAM_INPUT, SQL_C_CHAR,
SQL_CHAR, 50, 0, m_paramName, 50, NULL);
SQLBindParameter( // Связываем @paramCount с m_paramCount
hStmt, 2, SQL_PARAM_OUTPUT, SQL_C_SLONG,
SQL_INTEGER, 0, 4, &m_paramCount, 4, NULL);
}
:
CMyDatabase Db;
Db.OpenEx(
"DRIVER={SQL Server};SERVER=(local);DATABASE=tPeople;UID=sa;PWD=",
CDatabase::noOdbcDialog);
strcpy(Db.m_paramName, "Alexander");
Db.ExecuteSQL("{CALL spCount(?,?)}");
// Db.m_paramCount содержит результат!
Как видно из этого примера, входные параметры тоже можно связывать с переменными, и если нам нужно много раз вызывать хранимую процедуру с различными параметрами, это гораздо удобнее, чем формировать запросы при помощи sprintf.
Процедуры, возвращающие наборы записей, также вызываются с помощью оператора CALL, но в функции CRecordset::Open. Соответственно, полученное множество записей будет связано с объектом класса CRecordset. Если у хранимой процедуры есть параметры, можно передать их напрямую или связать с ними переменные. Связывание переменных, в отличие от предыдущего случая, происходит в функции CRecordset::DoFieldExchange при помощи макросов RFX_* (то есть практически ни чем не отличается от связывания переменных с полями результирующего набора записей). Нужно только вызвать CFieldExchange::SetFieldType с параметром CFieldExchange::inputParam, чтобы сообщить MFC, что мы связываем параметры, а не поля. Важно также записать количество связываемых параметров в переменную CRecordset::m_nParams. Обычно это делается в конструкторе класса.
Рассмотрим пример вызова хранимой процедуры spGetByName, которая находит в таблице tPeople всех людей с заданным именем. В СУБД SQL Server такую процедуру можно создать, выполнив запрос:
CREATE PROC spGetByName(@paramName CHAR(50))
AS SELECT * FROM tPeople WHERE Name=@paramName
Построить набор записей, в который входят все Александры из таблицы, теперь можно так (напоминаю, что нам придётся порождать новый класс от CRecordset).
class CPeople : public CRecordset {
public:
CPeople(CDatabase *pDatabase = NULL) : CRecordset(pDatabase) {
m_nFields = 2, m_nParams = 1;
};
CString m_Name;
Time m_DateOfBirth;
String m_paramName;
void DoFieldExchange(CFieldExchange *pFX);
};
void CPeople::DoFieldExchange(CFieldExchange *pFX) {
pFX->SetFieldType(CFieldExchange::outputColumn);
RFX_Text(pFX, "Name", m_Name, 50);
RFX_Date(pFX, "DateOfBirth", m_DateOfBirth);
pFX->SetFieldType(CFieldExchange::inputParam);
RFX_Text(pFX, "paramName", m_paramName);
}
:
CPeople Rs(&Db);
Rs.m_paramName = "Alexander";
Rs.Open(CRecordset::snapshot, "{CALL spGetByName(?)}");
В заключительном разделе я рассмотрю несколько не связанных между собою тем, знакомство с которыми может оказаться полезным.
Транзакции
Транзакция – это блок команд, которые выполняются как единое целое. Другими словами, они либо выполняются все, либо не выполняется ни одна. Транзакция начинается вызовом CDatabase::BeginTrans и завершается вызовом CDatabase::CommitTrans. Все операции по изменению, добавлению и удалению данных вступят в силу только после вызова CommitTrans, причём в любой момент до вызова этой функции транзакцию можно полностью отменить, вызвав функцию CDatabase::Rollback. Используйте CDatabase::CanTransact, чтобы определить, поддерживает ли используемый вами драйвер транзакции.
CRecordset и его потомки