다음을 통해 공유


SQLBulkOperations를 사용하여 행 삽입

SQLBulkOperations를 사용하여 데이터를 삽입하는 것은 바인딩된 애플리케이션 버퍼의 데이터를 사용하기 때문에 SQLBulkOperations를 사용하여 데이터를 업데이트하는 것과 비슷합니다.

새 행의 각 열에 값이 있으므로 길이/표시기 값이 SQL_COLUMN_IGNORE 모든 바인딩된 열과 모든 언바운드 열은 NULL 값을 허용하거나 기본값을 가져야 합니다.

SQLBulkOperations를 사용하여 행을 삽입하기 위해 애플리케이션은 다음을 수행합니다.

  1. SQL_ATTR_ROW_ARRAY_SIZE 문 특성을 삽입할 행 수로 설정하고 바인딩된 애플리케이션 버퍼에 새 데이터 값을 배치합니다. SQLBulkOperations사용하여 긴 데이터를 보내는 방법에 대한 자세한 내용은 Long Data 및 SQLSetPos 및 SQLBulkOperations를 참조하세요.

  2. 필요에 따라 각 열의 길이/표시기 버퍼의 값을 설정합니다. 문자열 버퍼에 바인딩된 열에 대한 데이터 또는 SQL_NTS 바이트 길이, 이진 버퍼에 바인딩된 열에 대한 데이터의 바이트 길이 및 NULL로 설정할 열에 대한 SQL_NULL_DATA. 애플리케이션은 해당 열의 길이/표시기 버퍼 값을 기본값(있는 경우)으로 설정하거나 NULL(없는 경우)을 SQL_COLUMN_IGNORE 설정합니다.

  3. operation 인수가 SQL_ADD 설정된 SQLBulkOperations를 호출합니다.

SQLBulkOperations가 반환되면 현재 행은 변경되지 않습니다. 책갈피 열(열 0)이 바인딩 된 경우 SQLBulkOperations 는 해당 열에 바인딩된 행 집합 버퍼에 삽입된 행의 책갈피를 반환합니다.