Определение признаков конца поля и строки

Символы, поддерживаемые в качестве признака конца

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

1 Для обозначения escape-символа с экранирующим символом обратной косой черты используются только символы t, n, r, 0 и «\0».

2 Хотя символ управления NULL (\0) не виден при печати, он является отдельным символом в файле данных, то есть если управляющий символ NULL используется в качестве признака конца поля или строки, то это не то же самое, что и полное отсутствие признака конца.

Важно!
Если символ признака конца поля или строки содержится в данных, он интерпретируется именно как признак, и данные после него интерпретируются как относящиеся к следующему полю или записи данных. Поэтому следует выбирать символы признака конца так, чтобы они никогда не встречались в передаваемых данных.

Использование признаков конца строки

Признаком конца строки может быть тот же символ, что и символ признака конца последнего поля. Но все же лучше выделить в качестве признака конца строки отдельный символ. Например, для формирования табличного вывода завершайте последнее поле каждой строки символом перевода строки (\n), а конец поля — символом табуляции (\t). Чтобы каждая строка файла данных попала в отдельную строку таблицы, в качестве признака конца строки задайте сочетание \r\n.

Примечание
При использовании программы bcp в интерактивном режиме, если в качестве признака конца строки задан символ \n (перевод строки), программа bcp автоматически добавляет к ней префикс \r (возврат каретки), в результате чего формируется признак конца строки \r\n.

Задание признаков конца полей и строк при массовом экспорте

При массовом экспорте данных типа char или nchar, если необходимо использовать признак, отличный от назначенного по умолчанию, определите его для команды bcp. Это можно сделать одним из следующих способов:

• При помощи файла форматирования, задающего признаки конца каждого поля отдельно.

  Примечание
  Дополнительные сведения о том, как использовать файлы форматирования, см. в разделе Файлы форматирования для импорта или экспорта данных.

• Существуют также следующие возможности без использования файла форматирования:

  • Указать параметр -t, задающий признак конца строки для всех полей, за исключением последнего поля в строке, и параметр -r, задающий признак конца строки.

  • Указать параметр символьного формата (-c или -w) без параметра -t, который назначает в качестве признака конца поля символ табуляции \t. Это аналогично указанию -t\t.

    Примечание
    Если указан параметр -n (данные в собственном формате) или -N (данные в собственном формате в кодировке Юникод), то признаки конца полей и строк не вставляются.

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

    Enter field terminator [none]:

    Обычно приемлемо значение по умолчанию. Однако для полей данных типа char или nchar существуют особенности, которые рассмотрены в следующем подразделе «Правила использования признаков конца полей и строк». Пример с описанием данного запроса в контексте см. в разделе Указание форматов данных для совместимости с помощью программы bcp.

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

Рекомендации по использованию признаков конца полей и строк

Примеры

bcp AdventureWorks2008R2.HumanResources.Department out C:\myDepartment-c-t.txt -c -t, -r \n -T

Задание признаков конца для массового импорта

При выполнении массового импорта данных типа char или nchar команда должна распознавать признаки конца полей и строк, используемые в файле данных. В зависимости от команды массового импорта признаки конца полей и строк могут задаваться следующим образом:

• bcp

  При определении признака конца полей и строк в операциях импорта используется тот же самый синтаксис, что и для операций экспорта. Дополнительные сведения см. в подразделе «Задание признаков конца полей и строк при массовом экспорте» ранее в этом разделе.

• BULK INSERT

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

  Квалификатор	Описание
  FIELDTERMINATOR ='field_terminator'	Задает признак конца поля, используемый для символьных файлов данных и файлов в кодировке Юникод. Признаком по умолчанию является \t (символ табуляции).
  ROWTERMINATOR ='row_terminator'	Задает признак конца строки, используемый для символьных файлов данных и файлов в кодировке Юникод. Признаком по умолчанию является \n (символ перевода строки).

  Дополнительные сведения см. в разделе BULK INSERT (Transact-SQL).

• Инструкции INSERT ... SELECT * FROM OPENROWSET(BULK...).

  Для поставщика массовых наборов строк OPENROWSET признаки конца могут задаваться только в файле форматирования (который обязателен для всех типов данных, кроме типа данных больших объектов). Если в файле символьных данных используется признак, отличный от установленного по умолчанию, он должен быть определен в файле форматирования. Дополнительные сведения см. в разделах Создание файла форматирования и Использование файла форматирования для массового импорта данных.

  Дополнительные сведения о предложении OPENROWSET BULK см. в разделе OPENROWSET (Transact-SQL).

Примеры

USE AdventureWorks2008R2;
GO
DROP TABLE myDepartment;
CREATE TABLE myDepartment 
(DepartmentID smallint,
Name nvarchar(50),
GroupName nvarchar(50) NULL,
ModifiedDate datetime not NULL CONSTRAINT DF_AddressType_ModifiedDate DEFAULT (GETDATE())
);
GO

bcp AdventureWorks2008R2..myDepartment in C:\myDepartment-c-t.txt -c -t , -r \n -T

USE AdventureWorks2008R2;
GO
BULK INSERT myDepartment FROM 'C:\myDepartment-c-t.txt'
   WITH (
      DATAFILETYPE = 'char',
      FIELDTERMINATOR = ',',
      ROWTERMINATOR = '\n'
);
GO

См. также

Справочник

Основные понятия