bcp_collen

  • 아티클

적용 대상:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse Analytics AnalyticsPlatform System(PDW)

현재 대량 복사에 대한 프로그램 변수의 데이터 길이를 SQL Server로 설정합니다.

구문

  
RETCODE bcp_collen (  
        HDBC hdbc,  
        DBINT cbData,  
        INT idxServerCol);

인수

hdbc
대량 복사 사용 ODBC 연결 핸들입니다.

cbData
길이 표시기 또는 종결자의 길이를 포함하지 않고 프로그램 변수의 데이터 길이입니다. cbData를 SQL_NULL_DATA 설정하면 서버에 복사된 모든 행에 열에 대한 NULL 값이 포함되어 있음을 나타냅니다. SQL_VARLEN_DATA 설정하면 문자열 종결자 또는 다른 메서드가 복사된 데이터의 길이를 결정하는 데 사용됨을 나타냅니다. 길이 표시기와 종결자가 모두 있는 경우 시스템은 어느 쪽을 사용하든 복사되는 데이터가 줄어듭니다.

idxServerCol
데이터가 복사되는 테이블의 열 서수 위치입니다. 첫 번째 열은 1입니다. 열의 서수 위치는 SQLColumns에서 보고됩니다.

반품

SUCCEED 또는 FAIL

설명

bcp_collen 함수를 사용하면 bcp_sendrow 사용하여 SQL Server에 데이터를 복사할 때 특정 열에 대한 프로그램 변수의 데이터 길이를 변경할 수 있습니다.

처음에는 bcp_bind 호출할 때 데이터 길이가 결정됩니다. bcp_sendrow 호출 간에 데이터 길이가 변경되고 길이 접두사 또는 종결자가 사용되지 않는 경우 bcp_collen 호출하여 길이를 다시 설정할 수 있습니다. 다음 bcp_sendrow 호출은 bcp_collen 호출에 의해 설정된 길이를 사용합니다.

데이터 길이를 수정하려는 테이블의 각 열에 대해 bcp_collen 한 번 호출 해야 합니다.

참고 항목

대량 복사 함수