bcp_sendrow
프로그램 변수에서 SQL Server로 데이터 행을 보냅니다.
구문
RETCODE bcp_sendrow (
HDBC hdbc);
인수
- hdbc
대량 복사가 가능한 ODBC 연결 핸들입니다.
반환 값
SUCCEED 또는 FAIL
주의
bcp_sendrow 함수는 프로그램 변수에서 행을 구성하여 SQL Server로 해당 행을 보냅니다.
bcp_sendrow를 호출하기 전에 bcp_bind를 호출하여 행 데이터가 들어 있는 프로그램 변수를 지정해야 합니다.
SQLTEXT의 eDataType 매개 변수와 같이 긴 가변 길이 데이터 형식과 NULL이 아닌 pData 매개 변수를 지정하여 bcp_bind를 호출한 경우 bcp_sendrow는 다른 데이터 형식의 경우와 마찬가지로 전체 데이터 값을 보냅니다. 하지만 bcp_bind에 NULL인 pData 매개 변수가 있는 경우 bcp_sendrow는 지정된 데이터가 있는 모든 열을 SQL Server로 보낸 후 즉시 제어를 응용 프로그램으로 반환합니다. 그러면 응용 프로그램이 bcp_moretext를 반복적으로 호출하여 한 번에 청크 하나씩 긴 가변 길이 데이터를 SQL Server로 보낼 수 있습니다. 자세한 내용은 bcp_moretext를 참조하십시오.
프로그램 변수에서 SQL Server 테이블로 행을 대량 복사하는 데 bcp_sendrow를 사용할 경우 사용자가 bcp_batch 또는 bcp_done을 호출할 경우에만 행이 커밋됩니다. 사용자는 bcp_batch를 n행마다 한 번씩 호출하거나 데이터가 연이어 들어오지 않을 경우 호출하도록 선택할 수 있습니다. bcp_batch가 호출되지 않으면 bcp_done이 호출될 때 행이 커밋됩니다.
SQL Server 2005부터 도입된 대량 복사의 주요 변경 사항에 대한 자세한 내용은 대량 복사 작업 수행(ODBC)을 참조하십시오.