Especificar terminadores de campo y de fila

Caracteres admitidos como terminadores

El comando bcp, la instrucción BULK INSERT y el proveedor de conjuntos de filas BULK OPENROWSET admiten una serie de caracteres como terminadores de campo o de fila y siempre buscan la primera instancia de cada terminador. La siguiente tabla enumera los caracteres admitidos como terminadores.

1 Solo pueden utilizarse los caracteres t, n, r, 0 y '\0' con el carácter de escape de barra diagonal inversa para crear un carácter de control.

2 Aunque el carácter de control NULL (\0) no sea visible al imprimir, es un carácter distintivo en el archivo de datos. Esto significa que el uso del carácter de control NULL como terminador de campo o de fila es diferente a no tener ningún terminador de campo o de fila.

Importante
Si en los datos hay un carácter terminador, se interpreta como un terminador, no como datos, y se interpreta que los datos posteriores a ese carácter pertenecen al campo o registro siguiente. Por lo tanto, elija los terminadores con atención para asegurarse de que nunca aparezcan en los datos.

Usar terminadores de fila

El terminador de fila puede ser el mismo carácter que el terminador del último campo. Sin embargo, normalmente resulta útil un terminador de fila distinto. Por ejemplo, para generar un resultado en formato tabular, termine el último campo de cada fila con el carácter de nueva línea (\n) y todos los demás campos con el carácter de tabulación (\t). Para colocar cada registro de datos en su propia línea del archivo de datos, especifique la combinación \r\n como terminador de fila.

Especificar terminadores para la exportación masiva

Si va a realizar una exportación masiva de datos char o nchar y desea usar un terminador no predeterminado, deberá especificar el terminador en el comando bcp. Los terminadores se pueden especificar de cualquiera de las siguientes maneras:

• Con un archivo de formato que especifica el terminador campo a campo.

  Nota

  Para obtener información acerca de cómo utilizar archivos de formato, vea Archivos de formato para importar o exportar datos.

• Sin un archivo de formato, existen las alternativas siguientes:

  • Usar el modificador -t para especificar el terminador de fila en todos los campos, excepto el último campo de la fila, y usar el modificador -r para especificar un terminador de fila.

  • Usar un modificador de formato de caracteres (-c o -w) sin el modificador -t, lo que establece el carácter de tabulación, \t, como terminador de campo. Esto equivale a especificar -t\t.

    Nota

    Si se especifica el modificador -n (datos nativos) o -N (nativos Unicode), no se insertan los terminadores.

  • Si un comando bcp interactivo contiene la opción in o out sin el modificador de archivo de formato (-f) ni un modificador de formato de datos (-n, -c, -w o -N), y ha decidido no especificar la longitud de prefijo ni la longitud de campo, el comando solicita el terminador de cada campo, con el valor predeterminado "none":

    Enter field terminator [none]:

    Generalmente, el valor predeterminado es una opción apropiada. Sin embargo, para los campos de datos char o nchar, vea la siguiente subsección, "Directrices para utilizar terminadores". Para consultar un ejemplo en el que se muestra esta solicitud en contexto, vea Especificar formatos de datos por razones de compatibilidad mediante bcp.

    Nota

    Una vez que se especifican de forma interactiva todos los campos de un comando bcp, el comando solicita su respuesta para cada campo en un archivo que no tiene el formato XML. Para obtener más información acerca de los archivos con formato no XML, vea Descripción de los archivos de formato no XML.

Directrices para utilizar terminadores

Ejemplos

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

Especificar terminadores para la importación masiva

Cuando realice una importación masiva de datos char o nchar, el comando de importación masiva debe reconocer los terminadores que se utilizan en el archivo de datos. La forma de especificar los terminadores depende del comando de importación masiva, tal como se indica a continuación:

• bcp

  La especificación de terminadores para una operación de importación usa la misma sintaxis que para una operación de exportación. Para obtener más información, vea "Especificar terminadores para la exportación masiva" anteriormente en este tema.

• BULK INSERT

  Los terminadores se pueden especificar para campos individuales en un archivo de formato o para todo el archivo de datos mediante los calificadores que figuran en la siguiente tabla:

  Calificador	Descripción
  FIELDTERMINATOR ='field_terminator'	Especifica el terminador de campo que se utilizará para los archivos de caracteres y de caracteres Unicode. El valor predeterminado es \t (carácter de tabulación).
  ROWTERMINATOR ='row_terminator'	Especifica el terminador de fila que se utilizará para los archivos de caracteres y de caracteres Unicode. El valor predeterminado es \n (carácter de nueva línea).

  Para obtener más información, vea BULK INSERT (Transact-SQL).

• INSERT ... SELECT * FROM OPENROWSET(BULK...)

  Para el proveedor de conjuntos de filas masivos OPENROWSET, los terminadores solo se pueden especificar en el archivo de formato (necesario excepto para tipos de datos de objetos grandes). Si un archivo de caracteres utiliza un terminador no predeterminado, debe definirse en el archivo de formato. Para obtener más información, vea Crear un archivo de formato y Usar un archivo de formato para importar datos de forma masiva.

  Para obtener más información acerca de la cláusula OPENROWSET BULK, vea OPENROWSET (Transact-SQL).

Ejemplos

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

Vea también

Referencia

Conceptos