Condividi tramite


bcp_sendrow

Si applica a: SQL Server Database SQL di Azure Istanza gestita di SQL di Azure Azure Synapse Analytics Piattaforma di strumenti analitici (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).

Vedi anche

Funzioni di copia bulk