CData ODBC Driver for QuickBooks Time は、ODBC Batch API を介してQuickBooks Time で一括ロードをサポートします。本製品 は、関連するSQL データ操作ステートメントを1つのバルクAPI 要求に変換することによって同時に実行できます。アプリケーションのコードでは、本製品 は一連の入力とパラメータ化されたクエリに基づいてステートメントを実行します。

バッチ更新プロシージャ

バッチ更新を実行するには、次の手順を実行してください。

1. ステートメント内の各パラメータのカラム値の配列を定義します。
2. SQL_ATTR_PARAMSET_SIZE ステートメント属性を設定します。
3. 各配列を各パラメータにバインドします。
4. パラメータ化されたステートメントを実行します。

一括挿入

次のコードは、SQLSetStmtAttr、SQLBindParameter、およびSQLExecDirect を使って一括挿入を実行する方法を示します。

SQLHSTMT pHstmt = NULL;
const int MAX_INSERT_COUNT = 2;
const int MAX_BUFFER_SIZE = 100;
char JobcodeIdArray[MAX_INSERT_COUNT][MAX_BUFFER_SIZE] = { 0 };
SQLLEN cbJobcodeIdArray[MAX_INSERT_COUNT] = { 0 };
...
retcode = SQLSetStmtAttr(pHstmt, SQL_ATTR_PARAMSET_SIZE, (SQLPOINTER)MAX_INSERT_COUNT, 0);
char *JobcodeId1 = "Jon Doe", *JobcodeId2 = "John";
cbJobcodeIdArray[0] = strlen(JobcodeId1);
cbJobcodeIdArray[1] = strlen(JobcodeId2);
memcpy(JobcodeIdArray[0], JobcodeId1, strlen(JobcodeId1));
memcpy(JobcodeIdArray[1], JobcodeId2, strlen(JobcodeId2));
retcode = SQLBindParameter(pHstmt, 1, SQL_PARAM_INPUT, SQL_C_CHAR, SQL_CHAR, 0, 0, JobcodeIdArray, MAX_BUFFER_SIZE, cbJobcodeIdArray);

retcode = SQLExecDirect(pHstmt, (SQLCHAR*) "INSERT INTO Timesheets (JobcodeId) VALUES (?)", SQL_NTS); 

一括更新

更新するレコードの主キーの配列を指定する必要があります。次のコードは、SQLSetStmtAttr、SQLBindParameter、およびSQLExecDirect を使って一括更新を実行する方法を示します。

SQLHSTMT pHstmt = NULL;
const int MAX_UPDATE_COUNT = 2;
const int MAX_BUFFER_SIZE = 100;
char IdArray[MAX_UPDATE_COUNT][MAX_BUFFER_SIZE] = { 0 };
char IdArray[MAX_UPDATE_COUNT][MAX_BUFFER_SIZE] = { 0 };
SQLLEN cbIdArray[MAX_UPDATE_COUNT] = { 0 };
SQLLEN cbIdArray[MAX_UPDATE_COUNT] = { 0 };
...
retcode = SQLSetStmtAttr(pHstmt, SQL_ATTR_PARAMSET_SIZE, (SQLPOINTER)MAX_UPDATE_COUNT, 0);
char *JobcodeId1 = "Jon Doe", *JobcodeId2 = "John";
char *Id1 = "Id1", *Id2 = "Id2";
cbJobcodeIdArray[0] = strlen(JobcodeId1);
cbJobcodeIdArray[1] = strlen(JobcodeId2);
cbIdArray[0] = strlen(Id1);
cbIdArray[1] = strlen(Id2);
memcpy(JobcodeIdArray[0], JobcodeId1, strlen(JobcodeId1));
memcpy(JobcodeIdArray[1], JobcodeId2, strlen(JobcodeId2));
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, JobcodeIdArray, MAX_BUFFER_SIZE, cbJobcodeIdArray);
retcode = SQLBindParameter(pHstmt, 2, SQL_PARAM_INPUT, SQL_C_CHAR, SQL_CHAR, 0, 0, IdArray, MAX_BUFFER_SIZE, cbIdArray);

retcode = SQLExecDirect(pHstmt, (SQLCHAR*) "UPDATE Timesheets SET JobcodeId = ? 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 Timesheets WHERE Id = ?", SQL_NTS);