다음을 통해 공유


bcp_sendrow

적용 대상: SQL Server Azure SQL 데이터베이스 Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System(PDW)

프로그램 변수에서 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 참조하세요.

bcp_sendrow 사용하여 프로그램 변수에서 SQL Server 테이블로 행을 대량 복사하는 경우 사용자가 bcp_batch 또는 bcp_done 호출하는 경우에만 행이 커밋됩니다. 사용자는 n행마다 한 번씩 또는 들어오는 데이터의 기간 사이에 소강 상태가 있는 경우 bcp_batch 호출하도록 선택할 수 있습니다. bcp_batch 호출되지 않으면 bcp_done 호출되면 행이 커밋됩니다.

SQL Server 2005(9.x)부터 대량 복사의 호환성이 손상되는 변경에 대한 자세한 내용은 ODBC(대량 복사 작업) 수행을 참조하세요.

참고 항목

대량 복사 함수