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)".