Поделиться через


bcp_collen

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

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

Синтаксис

  
RETCODE bcp_collen (  
        HDBC hdbc,  
        DBINT cbData,  
        INT idxServerCol);  

Аргументы

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

cbData
Длина данных в переменной программы, не включая длину признака длины или конца данных. Установка параметра cbData в значение SQL_NULL_DATA означает все строки, скопированные на сервер, которые содержат в столбце значение NULL. Установка в значение SQL_VARLEN_DATA означает, что для определения длины скопированных данных используется признак конца строки или другой метод. Если существует как признак длины, так и признак конца, система использует результат с меньшим количеством скопированных данных.

idxServerCol
Порядковый номер столбца таблицы, в которую копируются данные. Первый столбец имеет номер 1. Порядковый номер столбца возвращается функцией SQLColumns.

Возвраты

SUCCEED или FAIL.

Замечания

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

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

Для каждого столбца таблицы, длину данных которого нужно изменить, необходимо вызвать функцию bcp_collen .

См. также

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