バッチ処理
CData ODBC Driver for Salesforce は、ODBC Batch API を介してSalesforce で一括ロードをサポートします。本製品 は、関連するSQL データ操作ステートメントを1つのバルクAPI 要求に変換することによって同時に実行できます。アプリケーションのコードでは、本製品 は一連の入力とパラメータ化されたクエリに基づいてステートメントを実行します。
バッチ更新プロシージャ
バッチ更新を実行するには、次の手順を実行してください。
- ステートメント内の各パラメータのカラム値の配列を定義します。
- SQL_ATTR_PARAMSET_SIZE ステートメント属性を設定します。
- 各配列を各パラメータにバインドします。
- パラメータ化されたステートメントを実行します。
一括挿入
次のコードは、SQLSetStmtAttr、SQLBindParameter、およびSQLExecDirect を使って一括挿入を実行する方法を示します。
SQLHSTMT pHstmt = NULL;
const int MAX_INSERT_COUNT = 2;
const int MAX_BUFFER_SIZE = 100;
char NameArray[MAX_INSERT_COUNT][MAX_BUFFER_SIZE] = { 0 };
SQLLEN cbNameArray[MAX_INSERT_COUNT] = { 0 };
...
retcode = SQLSetStmtAttr(pHstmt, SQL_ATTR_PARAMSET_SIZE, (SQLPOINTER)MAX_INSERT_COUNT, 0);
char *Name1 = "Jon Doe", *Name2 = "John";
cbNameArray[0] = strlen(Name1);
cbNameArray[1] = strlen(Name2);
memcpy(NameArray[0], Name1, strlen(Name1));
memcpy(NameArray[1], Name2, strlen(Name2));
retcode = SQLBindParameter(pHstmt, 1, SQL_PARAM_INPUT, SQL_C_CHAR, SQL_CHAR, 0, 0, NameArray, MAX_BUFFER_SIZE, cbNameArray);
retcode = SQLExecDirect(pHstmt, (SQLCHAR*) "INSERT INTO Account (Name) VALUES (?)", SQL_NTS);
新しいレコードのId を取得するには、LastResultInfo テーブルをクエリします。
SQLExecDirect(hstmt, (SQLTCHAR*)"SELECT * FROM LastResultInfo#TEMP", SQL_NTS);
SQLTCHAR sId[20] = {0};
SQLLEN cbId = 0;
SQLBindCol(hstmt, 1, SQL_C_CHAR, sId, 20, &cbId);
SQLRETURN retcode = SQLFetch(hstmt);
一括更新
更新するレコードの主キーの配列を指定する必要があります。次のコードは、SQLSetStmtAttr、SQLBindParameter、およびSQLExecDirect を使って一括更新を実行する方法を示します。
SQLHSTMT pHstmt = NULL;
const int MAX_UPDATE_COUNT = 2;
const int MAX_BUFFER_SIZE = 100;
char BillingStateArray[MAX_UPDATE_COUNT][MAX_BUFFER_SIZE] = { 0 };
char IdArray[MAX_UPDATE_COUNT][MAX_BUFFER_SIZE] = { 0 };
SQLLEN cbBillingStateArray[MAX_UPDATE_COUNT] = { 0 };
SQLLEN cbIdArray[MAX_UPDATE_COUNT] = { 0 };
...
retcode = SQLSetStmtAttr(pHstmt, SQL_ATTR_PARAMSET_SIZE, (SQLPOINTER)MAX_UPDATE_COUNT, 0);
char *Name1 = "Jon Doe", *Name2 = "John";
char *Id1 = "Id1", *Id2 = "Id2";
cbNameArray[0] = strlen(Name1);
cbNameArray[1] = strlen(Name2);
cbIdArray[0] = strlen(Id1);
cbIdArray[1] = strlen(Id2);
memcpy(NameArray[0], Name1, strlen(Name1));
memcpy(NameArray[1], Name2, strlen(Name2));
memcpy(IdArray[0], Id1, strlen(Id1));
memcpy(IdArray[1], Id2, strlen(Id2));
retcode = SQLBindParameter(pHstmt, 1, SQL_PARAM_INPUT, SQL_C_CHAR, SQL_CHAR, 0, 0, NameArray, MAX_BUFFER_SIZE, cbNameArray);
retcode = SQLBindParameter(pHstmt, 2, SQL_PARAM_INPUT, SQL_C_CHAR, SQL_CHAR, 0, 0, IdArray, MAX_BUFFER_SIZE, cbIdArray);
retcode = SQLExecDirect(pHstmt, (SQLCHAR*) "UPDATE Account SET Name = ? WHERE Id = ?", SQL_NTS);
一括削除
削除するレコードの主キーの配列を指定する必要があります。次のコードは、SQLSetStmtAttr、SQLBindParameter、およびSQLExecDirect を使って一括削除を実行する方法を示します。
SQLHSTMT pHstmt = NULL;
const int MAX_DELETE_COUNT = 2;
const int MAX_BUFFER_SIZE = 100;
char IdArray[MAX_DELETE_COUNT][MAX_BUFFER_SIZE] = { 0 };
SQLLEN cbIdArray[MAX_DELETE_COUNT] = { 0 };
...
retcode = SQLSetStmtAttr(pHstmt, SQL_ATTR_PARAMSET_SIZE, (SQLPOINTER)MAX_DELETE_COUNT, 0);
char *Id1 = "Id1", *Id2 = "Id2";
cbIdArray[0] = strlen(Id1);
cbIdArray[1] = strlen(Id2);
memcpy(IdArray[0], Id1, strlen(Id1));
memcpy(IdArray[1], Id2, strlen(Id2));
retcode = SQLBindParameter(pHstmt, 1, SQL_PARAM_INPUT, SQL_C_CHAR, SQL_CHAR, 0, 0, IdArray, MAX_BUFFER_SIZE, cbIdArray);
retcode = SQLExecDirect(pHstmt, (SQLCHAR*) "DELETE FROM Account WHERE Id = ?", SQL_NTS);