bcp_sendrow

Se aplica a:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)

Envía una fila de datos de variables de programa a SQL Server.

Sintaxis

  
RETCODE bcp_sendrow (  
    HDBC hdbc);  

Argumentos

hdbc
Es el identificador de la conexión ODBC habilitada para la copia masiva.

Devoluciones

SUCCEED o FAIL.

Comentarios

La función bcp_sendrow crea una fila a partir de variables de programa y la envía a SQL Server.

Antes de llamar a a bcp_sendrow, debe hacer llamadas a bcp_bind para especificar las variables de programa que contienen los datos de la fila.

Si se llama a bcp_bind especificando un tipo de datos de longitud variable larga, por ejemplo, un parámetro eDataType de SQLTEXT y un parámetro pData no NULL, bcp_sendrow envía todo el valor de datos, igual que para cualquier otro tipo de datos. Sin embargo, si bcp_bind tiene un parámetro pData NULL, bcp_sendrow devuelve el control a la aplicación inmediatamente después de enviar todas las columnas con datos especificados a SQL Server. A continuación, la aplicación puede llamar a bcp_moretext varias veces para enviar los datos largos y de longitud variable a SQL Server, un fragmento a la vez. Para obtener más información, vea bcp_moretext.

Cuando se usa bcp_sendrow para copiar de forma masiva filas de variables de programa en tablas de SQL Server, las filas solo se confirman cuando el usuario llama a bcp_batch o bcp_done. El usuario puede elegir llamar a bcp_batch una vez cada n filas o cuando haya un periodo de inactividad entre períodos de entrada de datos. Si nunca se llama a bcp_batch , las filas se confirman cuando se llama a bcp_done .

Para obtener información sobre un cambio importante en la copia masiva a partir de SQL Server 2005 (9.x), vea Realizar operaciones de copia masiva (ODBC).

Consulte también

Bulk Copy Functions