bcp_sendrow

Применимо: SQL Server База данных SQL Azure Управляемый экземпляр SQL Azure azure Synapse Analytics Analytics Platform System (PDW)

Отправляет строку данных из переменных программы в SQL Server.

Синтаксис

  
RETCODE bcp_sendrow (  
    HDBC hdbc);  

Аргументы

hdbc
Дескриптор соединения ODBC с поддержкой массового копирования.

Возвраты

SUCCEED или FAIL.

Замечания

Функция bcp_sendrow создает строку из переменных программы и отправляет ее в SQL Server.

Перед вызовом функции bcp_sendrowнеобходимо вызвать функцию bcp_bind , чтобы указать переменные программы, содержащие данные строки.

Если bcp_bind вызывается при указании длинного типа данных переменной длины, например, параметра eDataType SQLTEXT и параметра pData, отличного от NULL, bcp_sendrow отправляет все значение данных так же, как и для любого другого типа данных. Однако если bcp_bind имеет параметр null pData , bcp_sendrow возвращает управление приложению сразу после отправки всех столбцов с указанными данными в SQL Server. Затем приложение может вызывать bcp_moretext многократно отправлять длинные данные переменной длины в SQL Server, блок за раз. Дополнительные сведения см. в разделе bcp_moretext.

Если bcp_sendrow используется для массового копирования строк из переменных программы в таблицы SQL Server, строки фиксируются только при вызове пользователем bcp_batch или bcp_done. Пользователь может вызывать функцию bcp_batch один раз для каждой из n строк или во время перерыва между периодами поступления данных. Если функция bcp_batch никогда не вызывается, то строки фиксируются при вызове функции bcp_done .

Сведения о критическом изменении массового копирования, начиная с SQL Server 2005 (9.x), см. в разделе "Выполнение операций массового копирования( ODBC)".

См. также

Функции массового копирования