bcp_sendrow
Si applica a:
SQL Server database SQL di Azure Istanza gestita di SQL di Azure azure Synapse Analytics Analytics Platform System (PDW)
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.
Valori restituiti
SUCCEED o FAIL.
Osservazioni:
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 diverso da NULL, bcp_sendrow invia l'intero valore di dati, come per qualsiasi altro tipo di dati. Se, tuttavia, bcp_bind ha un parametro pData NULL, bcp_sendrow restituisce il controllo all'applicazione immediatamente dopo l'invio di tutte le colonne con dati specificati a SQL Server. L'applicazione può quindi chiamare ripetutamente bcp_moretext per inviare i dati di lunghezza variabile lunghi a SQL Server, un blocco alla volta. Per altre informazioni, vedere bcp_moretext.
Quando bcp_sendrow viene usato per copiare in blocco righe dalle variabili di programma nelle tabelle di 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 (9.x), vedere Esecuzione di operazioni di copia bulk (ODBC).