bcp_collen
Si applica a:
SQL Server database SQL di Azure Istanza gestita di SQL di Azure azure Synapse Analytics Analytics Platform System (PDW)
Imposta la lunghezza dei dati nella variabile di programma per la copia bulk corrente in SQL Server.
Sintassi
RETCODE bcp_collen (
HDBC hdbc,
DBINT cbData,
INT idxServerCol);
Argomenti
hdbc
Handle di connessione ODBC abilitato per la copia bulk.
cbData
Lunghezza dei dati nella variabile di programma esclusa la lunghezza dei caratteri di terminazione o degli indicatori di lunghezza. L'impostazione di cbData su SQL_NULL_DATA indica che tutte le righe copiate nel server contengono un valore NULL per la colonna. L'impostazione di cbData su SQL_VARLEN_DATA indica che verrà utilizzato un carattere di terminazione della stringa o un altro metodo per determinare la lunghezza dei dati copiati. Se sono presenti sia un indicatore di lunghezza che un carattere di terminazione, il sistema utilizzerà il metodo che comporta la copia del minor numero di dati.
idxServerCol
Posizione ordinale della colonna nella tabella in cui vengono copiati i dati. La prima colonna è 1. La posizione ordinale di una colonna viene segnalata da SQLColumns.
Valori restituiti
SUCCEED o FAIL.
Osservazioni:
La funzione bcp_collen consente di modificare la lunghezza dei dati nella variabile di programma per una determinata colonna durante la copia dei dati in SQL Server con bcp_sendrow.
Inizialmente, la lunghezza dei dati viene determinata quando viene chiamato bcp_bind . Se la lunghezza dei dati cambia tra le chiamate a bcp_sendrow e non viene usato alcun prefisso di lunghezza o terminatore, è possibile chiamare bcp_collen per reimpostare la lunghezza. La chiamata successiva a bcp_sendrow usa la lunghezza impostata dalla chiamata a bcp_collen.
È necessario chiamare bcp_collen una volta per ogni colonna della tabella la cui lunghezza dei dati si desidera modificare.