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


Указание длины поля с помощью программы bcp (SQL Server)

Длина поля указывает максимальное количество символов, необходимых для представления данных в символьном формате. Длина поля известна заранее, если данные хранятся в собственном формате, например значение типа int занимает 4 байта. Если вы указали значение 0 для длины префикса, команда bcp предложит указать длину поля, длину полей по умолчанию и влияние длины поля на хранение данных в файлах данных, содержащих char данные.

Запрос командой bcp значения длины поля

Если интерактивная команда bcp содержит параметр in или out без параметра файла форматирования ( -f) либо параметра формата данных ( -n, -c, -w или -N), то команда запрашивает длину каждого поля данных следующим образом:

Enter length of field <field_name> [<default>]:

Пример, демонстрирующий этот запрос в контексте, см. в разделе Указание форматов данных для совместимости при использовании bcp (SQL Server)).

Примечание

После интерактивного заполнения всех полей в команде bcp появится запрос на сохранение введенных ответов для каждого поля в файле форматирования в формате, отличном от XML. Дополнительные сведения о файлах форматирования, отличных от XML, см. в разделе Файлы форматирования, отличные от XML (SQL Server)..

Будут ли командные строки bcp выводить запросы для указания значений длины полей, зависит от нескольких факторов, как указано ниже.

  • Если происходит копирование данных таких типов, которые не имеют постоянной длины, и задана длина префикса, равная 0, то bcp выводит приглашения для указания длины полей.

  • Если происходит преобразование несимвольных данных в символьные данные, то bcp предлагает по умолчанию длину поля, достаточно большую для сохранения данных.

  • Если по своему типу хранилище файлов не является символьным, то команда bcp не выводит приглашения для указания длины полей. Данные хранятся в собственном представлении данных Microsoft SQL Server (в собственном формате).

Использование значения длины поля по умолчанию

В общем случае Microsoft рекомендует принимать значения по умолчанию для длины полей, предлагаемые командой bcp. Использование значений длины поля по умолчанию при создании файла символьных данных помогает избежать усечения данных и возникновения ошибок переполнения.

При указании некорректного значения длины поля могут возникнуть проблемы. Например, если при копировании числовых данных была задана слишком малая длина поля, программа bcp выдает сообщение о переполнении, а копирование данных не выполняется. Кроме того, если вы экспортируете datetime данные и указываете длину поля менее 26 байт для символьной строки, служебная программа bcp усекает данные без сообщения об ошибке.

Важно!

При использовании размера, заданного по умолчанию, SQL Server считывает всю строку. В некоторых случаях использование значения длины поля по умолчанию приводит к возникновению ошибки «неожиданный конец файла». Как правило, эта ошибка возникает с типами money данных и datetime , когда в файле данных встречается только часть ожидаемого поля, например, если datetime значение мм/дд/гг указано без компонента времени и, следовательно, меньше ожидаемой длины 24 символов datetime значения в char формате. Чтобы избежать указанной ошибки типов, необходимо использовать признаки конца поля или файлы данных фиксированной длины, либо изменить значение длины поля по умолчанию.

Значения длины поля по умолчанию для файлов символьных данных

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

Тип данных Длина по умолчанию (в символах)
char Длина, определенная для столбца
varchar Длина, определенная для столбца
nchar Удвоенная длина, определенная для столбца
nvarchar Удвоенная длина, определенная для столбца
Text 0
ntext 0
bit 1
binary Удвоенная длина, определенная для столбца + 1
varbinary Удвоенная длина, определенная для столбца + 1
image 0
datetime 24
smalldatetime 24
float 30
real 30
int 12
bigint 19
smallint 7
tinyint 5
money 30
smallmoney 30
decimal 41*
numeric 41*
uniqueidentifier 37
timestamp 17
varchar(max) 0
varbinary(max) 0
nvarchar(max) 0
(UDT) Длина столбца определенного пользователем типа (UDT)
XML 0

*Дополнительные сведения о типах данных и numeric см. в decimal разделе Десятичные и числовые (Transact-SQL).

Примечание

Столбец данных типа tinyint может содержать целые значения от 0 до 255; максимальное количество символов, необходимых для представления чисел данного диапазона, равно 3 (для записи чисел от 100 до 255).

Значения длины поля по умолчанию для файлов собственных данных

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

Тип данных Длина по умолчанию (в символах)
bit 1
binary Длина, определенная для столбца
varbinary Длина, определенная для столбца
image 0
datetime 8
smalldatetime 4
float 8
real 4
int 4
bigint 8
smallint 2
tinyint 1
money 8
smallmoney 4
decimal1 *
numeric1 *
uniqueidentifier 16
timestamp 8

1 Дополнительные сведения о типах данных и numeric см. в decimal разделе Decimal and numeric (Transact-SQL).

Во всех перечисленных случаях для создания файла данных для SQL Server , занимающего наименьшее количество памяти, необходимо использовать префикс, задающий тип файлов и длину поля по умолчанию.

См. также:

Программа bcp
Типы данных (Transact-SQL)
Определение признаков конца поля и строки (SQL Server)
Определение длины префикса в файлах данных с помощью программы bcp (SQL Server)
Указание типа файлового хранилища с помощью программы bcp (SQL Server)
Сохранение значений NULL или использование значений по умолчанию при массовом импорте данных (SQL Server)