bcp_collen

Dotyczy:sql ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse Analytics

Ustawia długość danych w zmiennej programowej dla bieżącej kopii zbiorczej do SQL Server.

Syntax

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

Arguments

hdbc
Czy obsługa połączenia ODBC z obsługą kopiowania zbiorczego.

cbData
To długość danych w zmiennej programowej, nie licząc długości żadnego wskaźnika długości ani terminatora. Ustawienie cbData na SQL_NULL_DATA oznacza, że wszystkie wiersze skopiowane na serwer zawierają wartość NULL dla kolumny. Ustawienie na SQL_VARLEN_DATA oznacza, że do określenia długości kopiowanych danych używany jest terminator ciągu lub inna metoda. Jeśli istnieją zarówno wskaźnik długości, jak i terminator, system używa tego, który skutkuje mniejszą liczbą kopiowanych danych.

idxServerCol
Jest porządkową pozycją kolumny w tabeli, do której dane są kopiowane. Pierwsza kolumna to 1. Pozycja porządkowa kolumny jest podawana przez SQLColumns.

Zwroty

POWODZENIE lub NIEPOWODZENIE.

Remarks

Funkcja bcp_collen pozwala zmienić długość danych w zmiennej programowej dla konkretnej kolumny podczas kopiowania danych do SQL Server z bcp_sendrow.

Początkowo długość danych jest ustalana w momencie wywołania bcp_bind . Jeśli długość danych zmienia się między wywołaniami do bcp_sendrow i nie używa się prefiksu długości ani terminatora, możesz wywołać bcp_collen , aby zresetować długość. Kolejne wywołanie do bcp_sendrow wykorzystuje długość ustaloną przez wywołanie do bcp_collen.

Musisz wywołać bcp_collen raz dla każdej kolumny w tabeli, której długość danych chcesz zmienić.

Treści powiązane

• Rozszerzenia sterowników SQL Server - funkcje kopiowania masowego