bcp_sendrow
Invia una riga di dati dalle variabili di programma a SQL Server.
Sintassi
RETCODE bcp_sendrow (
HDBC
hdbc
);
Argomenti
hdbc
Handle di connessione ODBC abilitato per la copia bulk.
Restituisce
SUCCEED o FAIL.
Commenti
La funzione bcp_sendrow compila una riga dalle variabili di programma e la invia a SQL Server.
Prima di chiamare bcp_sendrow, è necessario effettuare chiamate a bcp_bind per specificare le variabili di programma contenenti dati di riga.
Se bcp_bind viene chiamato specificando un tipo di dati long a lunghezza variabile, ad esempio un parametro eDataType di SQLTEXT e un parametro pData nonNULL, bcp_sendrow invia l'intero valore di dati, esattamente come per qualsiasi altro tipo di dati. Se, tuttavia, bcp_bind ha un parametro null pData, bcp_sendrow restituisce il controllo all'applicazione immediatamente dopo che tutte le colonne con dati specificati vengono inviate a SQL Server. L'applicazione può quindi chiamare ripetutamente bcp_moretext per inviare i dati a lunghezza variabile e lunga a SQL Server, un blocco alla volta. Per altre informazioni, vedere bcp_moretext.
Quando bcp_sendrow viene usato per copiare in blocco righe da variabili di programma in tabelle SQL Server, viene eseguito il commit delle righe solo quando l'utente chiama bcp_batch o bcp_done. L'utente può scegliere di chiamare bcp_batch una volta ogni n righe o quando è presente un intervallo tra periodi di dati in ingresso. Se bcp_batch non viene mai chiamato, viene eseguito il commit delle righe quando viene chiamato bcp_done .
Per informazioni su una modifica di rilievo nella copia bulk a partire da SQL Server 2005, vedere Esecuzione di operazioni di copia bulk (ODBC).