Crear un archivo de formato (SQL Server)

  • Artículo

Cuando se realiza una importación masiva de datos en una tabla de SQL Server o una exportación masiva de datos desde una tabla, se puede utilizar un archivo de formato para un sistema flexible de escribir archivos de datos que requiera poca o ninguna modificación para adaptarlos a otros formatos de datos o para leer archivos de datos de otros programas de software.

SQL Server admite dos tipos de archivos de formato: XML y no XML. El formato no XML es el formato original compatible con versiones anteriores de SQL Server.

Por lo general, los archivos de formato XML y no XML son intercambiables. Sin embargo, es recomendable utilizar la sintaxis XML para los nuevos archivos de formato porque proporciona varias ventajas con relación a los archivos de formato no XML.

[!NOTA]

La versión de la utilidad bcp (Bcp.exe) que se emplee para leer un archivo de formato debe ser la misma versión, o una versión posterior, que se use para crear el archivo de formato. Por ejemplo, la utilidad bcp de SQL Server 2008 puede leer un archivo de formato con la versión 9.0, que se genera en la utilidad bcp de SQL Server 2005, pero la utilidad bcp de SQL Server 2005 no puede leer un archivo de formato con la versión 10.0, que se genera en la utilidad bcp de SQL Server 2008.

En este tema se describe cómo utilizar la utilidad bcp para crear un archivo de formato para una tabla determinada. El archivo de formato se basa en la opción de tipo de datos especificada (-n, -c, -w o -N) y en los delimitadores de la vista o de la tabla.

Crear un archivo de formato no XML

Si desea usar un comando bcp para crear un archivo de formato, especifique el argumento format y use nul en lugar de una ruta de acceso de archivo de datos. La opción format también requiere la opción -f, como:

bcp table_or_view format nul -f format_file_name

[!NOTA]

Para distinguir un archivo de formato no XML, se recomienda utilizar .fmt como extensión del nombre de archivo, por ejemplo, miTabla.fmt.

Para obtener información acerca de la estructura y los campos de los archivos de formato no XML, vea Archivos de formato no XML [SQL Server].

Ejemplos

Esta sección contiene los siguientes ejemplos que muestran cómo se usan los comandos de bcp para crear un archivo de formato no XML:

  • A. Crear un archivo de formato no XML para datos nativos

  • B. Crear un archivo de formato no XML para datos de caracteres

  • C. Crear un archivo de formato no XML para datos nativos Unicode

  • D. Crear un archivo de formato no XML para datos de caracteres Unicode

Los ejemplos usan la tabla HumanResources.Department de la base de datos de ejemplo AdventureWorks2012 . La tabla HumanResources.Department tiene cuatro columnas: DepartmentID, Name, GroupName y ModifiedDate.

[!NOTA]

Adventure Works Cycles es una compañía ficticia que se utiliza para mostrar situaciones y conceptos de bases de datos.

A.Crear un archivo de formato no XML para datos nativos

En este ejemplo se crea un archivo de formato XML, Department-n.xml, para la tabla HumanResources.Department de AdventureWorks2012. El archivo de formato utiliza tipos de datos nativos. El contenido del archivo de formato generado se presenta después del comando.

El comando bcp contiene los calificadores siguientes.

Calificadores

Descripción

format nul -f format_file

Especifica el archivo de formato no XML.

-n

Especifica tipos de datos nativos.

-T

Especifica que la utilidad bcp se va a conectar a SQL Server mediante una conexión de confianza que usa la seguridad integrada. Si no se especifica -T, deberá especificar -U y -P para poder iniciar sesión correctamente.

En el símbolo del sistema de Windows, escriba el siguiente comando bcp:

bcp AdventureWorks2012.HumanResources.Department format nul -T -n -f Department-n.fmt

El archivo de formato generado, Department-n.fmt, contiene la siguiente información:

9.0
4
1       SQLSMALLINT   0       2       ""   1     DepartmentID                 ""
2       SQLNCHAR      2       100     ""   2     Name                         SQL_Latin1_General_CP1_CI_AS
3       SQLNCHAR      2       100     ""   3     GroupName                    SQL_Latin1_General_CP1_CI_AS
4       SQLDATETIME   0       8       ""   4     ModifiedDate                 ""

Para obtener más información, vea Archivos de formato no XML [SQL Server].

B.Crear un archivo de formato no XML para datos de caracteres

En este ejemplo se crea un archivo de formato XML, Department.fmt, para la tabla HumanResources.Department de AdventureWorks2012. El archivo de formato usa formatos de datos de caracteres y un terminador de campo no predeterminado (,). El contenido del archivo de formato generado se presenta después del comando.

El comando bcp contiene los calificadores siguientes.

Calificadores

Descripción

format nul -f format_file

Especifica un archivo de formato no XML.

-c

Especifica los datos de caracteres.

-T

Especifica que la utilidad bcp se va a conectar a SQL Server mediante una conexión de confianza que usa la seguridad integrada. Si no se especifica -T, deberá especificar -U y -P para poder iniciar sesión correctamente.

En el símbolo del sistema de Windows, escriba el siguiente comando bcp:

bcp AdventureWorks2012.HumanResources.Department format nul -c -f Department-c.fmt -T

El archivo de formato generado, Department-c.fmt, contiene la siguiente información:

9.0
4
1       SQLCHAR       0       7       "\t"     1     DepartmentID                 ""
2       SQLCHAR       0       100     "\t"     2     Name                         SQL_Latin1_General_CP1_CI_AS
3       SQLCHAR       0       100     "\t"     3     GroupName                    SQL_Latin1_General_CP1_CI_AS
4       SQLCHAR       0       24      "\r\n"   4     ModifiedDate                 ""

Para obtener más información, vea Archivos de formato no XML [SQL Server].

C.Crear un archivo de formato no XML para datos nativos Unicode

Para crear un archivo de formato no XML para datos nativos Unicode para la tabla HumanResources.Department, utilice el comando siguiente:

bcp AdventureWorks2012.HumanResources.Department format nul -T -N -f Department-n.fmt

Para obtener más información acerca de cómo utilizar los datos nativos Unicode, vea Usar el formato nativo Unicode para importar o exportar datos (SQL Server).

D.Crear un archivo de formato no XML para datos de caracteres Unicode

Para crear un archivo de formato no XML para datos de caracteres Unicode para la tabla HumanResources.Department que usa terminadores predeterminados, use el comando siguiente:

bcp AdventureWorks2012.HumanResources.Department format nul -T -w -f Department-w.fmt

Para obtener más información acerca del uso de datos de caracteres Unicode, vea Usar el formato de caracteres Unicode para importar o exportar datos (SQL Server).

Crear un archivo de formato XML

Si desea usar un comando bcp para crear un archivo de formato, especifique el argumento format y use nul en lugar de una ruta de acceso de archivo de datos. La opción format siempre requiere la -f y, para crear un archivo de formato XML, también debe especificar la opción -x, como:

bcp table_or_view format nul -f format_file_name -x

[!NOTA]

Para distinguir un archivo de formato XML, se recomienda utilizar .xml como extensión de archivo, por ejemplo, miTabla.xml.

Para obtener información acerca de la estructura y los campos de los archivos de formato XML, vea XML, archivos de formato (SQL Server).

Ejemplos

Esta sección contiene los siguientes ejemplos en los que se muestran cómo se usan los comandos bcp para crear un archivo de formato XML:

  • A. Crear un archivo de formato XML para datos de caracteres

  • B. Crear un archivo de formato XML para datos nativos

Los ejemplos utilizan la tabla HumanResources.Department de la base de datos de ejemplo AdventureWorks2012 . La tabla HumanResources.Department tiene cuatro columnas: DepartmentID, Name, GroupName y ModifiedDate.

[!NOTA]

Adventure Works Cycles es una compañía ficticia que se utiliza para mostrar situaciones y conceptos de bases de datos.

A.Crear un archivo de formato XML para datos de caracteres

En este ejemplo se crea un archivo de formato XML, Department.xml, para la tabla HumanResources.Department de AdventureWorks2012. El archivo de formato usa formatos de datos de caracteres y un terminador de campo no predeterminado (,). El contenido del archivo de formato generado se presenta después del comando.

El comando bcp contiene los calificadores siguientes.

Calificadores

Descripción

format nul -f format_file -x

Especifica el archivo de formato XML.

-c

Especifica los datos de caracteres.

-t ,

Especifica una coma (,) como terminador de campo.

[!NOTA]

Si el archivo de datos usa el terminador de campo predeterminado (\t), no es necesario el modificador -t.

-T

Especifica que la utilidad bcp se va a conectar a SQL Server mediante una conexión de confianza que usa la seguridad integrada. Si no se especifica -T, deberá especificar -U y -P para poder iniciar sesión correctamente.

En el símbolo del sistema de Windows, escriba el siguiente comando bcp:

bcp AdventureWorks2012.HumanResources.Department format nul -c -x -f Department-c..xml –t, -T

El archivo de formato generado, Department-c.xml, contiene los elementos XML siguientes:

<?xml version="1.0"?>
<BCPFORMAT xmlns="https://schemas.microsoft.com/sqlserver/2004/bulkload/format" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
 <RECORD>
  <FIELD ID="1" xsi:type="CharTerm" TERMINATOR="," MAX_LENGTH="7"/>
  <FIELD ID="2" xsi:type="CharTerm" TERMINATOR="," MAX_LENGTH="100" COLLATION="SQL_Latin1_General_CP1_CI_AS"/>
  <FIELD ID="3" xsi:type="CharTerm" TERMINATOR="," MAX_LENGTH="100" COLLATION="SQL_Latin1_General_CP1_CI_AS"/>
  <FIELD ID="4" xsi:type="CharTerm" TERMINATOR="\r\n" MAX_LENGTH="24"/>
 </RECORD>
 <ROW>
  <COLUMN SOURCE="1" NAME="DepartmentID" xsi:type="SQLSMALLINT"/>
  <COLUMN SOURCE="2" NAME="Name" xsi:type="SQLNVARCHAR"/>
  <COLUMN SOURCE="3" NAME="GroupName" xsi:type="SQLNVARCHAR"/>
  <COLUMN SOURCE="4" NAME="ModifiedDate" xsi:type="SQLDATETIME"/>
 </ROW>
</BCPFORMAT>

Para obtener información acerca de la sintaxis de este archivo de formato, vea XML, archivos de formato (SQL Server). Para obtener información acerca de los datos de caracteres, vea Usar el formato de caracteres para importar o exportar datos (SQL Server).

B.Crear un archivo de formato XML para datos nativos

En el ejemplo siguiente se crea un archivo de formato XML, Department-n.xml, para la tabla HumanResources.Department. El archivo de formato utiliza tipos de datos nativos. El contenido del archivo de formato generado se presenta después del comando.

El comando bcp contiene los calificadores siguientes.

Calificadores

Descripción

format nul -f format_file -x

Especifica el archivo de formato XML.

-n

Especifica tipos de datos nativos.

-T

Especifica que la utilidad bcp se va a conectar a SQL Server mediante una conexión de confianza que usa la seguridad integrada. Si no se especifica -T, deberá especificar -U y -P para poder iniciar sesión correctamente.

En el símbolo del sistema de Windows, escriba el siguiente comando bcp:

bcp AdventureWorks2012.HumanResources.Department format nul -x -f Department-n..xml -n -T

El archivo de formato generado, Department-n.xml, contiene los elementos XML siguientes:

<?xml version="1.0"?>
<BCPFORMAT xmlns="https://schemas.microsoft.com/sqlserver/2004/bulkload/format" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
 <RECORD>
  <FIELD ID="1" xsi:type="NativeFixed" LENGTH="2"/>
  <FIELD ID="2" xsi:type="NCharPrefix" PREFIX_LENGTH="2" MAX_LENGTH="100" COLLATION="SQL_Latin1_General_CP1_CI_AS"/>
  <FIELD ID="3" xsi:type="NCharPrefix" PREFIX_LENGTH="2" MAX_LENGTH="100" COLLATION="SQL_Latin1_General_CP1_CI_AS"/>
  <FIELD ID="4" xsi:type="NativeFixed" LENGTH="8"/>
 </RECORD>
 <ROW>
  <COLUMN SOURCE="1" NAME="DepartmentID" xsi:type="SQLSMALLINT"/>
  <COLUMN SOURCE="2" NAME="Name" xsi:type="SQLNVARCHAR"/>
  <COLUMN SOURCE="3" NAME="GroupName" xsi:type="SQLNVARCHAR"/>
  <COLUMN SOURCE="4" NAME="ModifiedDate" xsi:type="SQLDATETIME"/>
 </ROW>
</BCPFORMAT>

Para obtener información acerca de la sintaxis de este archivo de formato, vea XML, archivos de formato (SQL Server). Para obtener información acerca del uso de datos nativos, vea Usar el formato nativo para importar o exportar datos (SQL Server).

Asignar campos de datos a columnas de tabla

Al igual que cuando se crea mediante bcp, un archivo de formato describe todas las columnas de tabla en orden. Puede modificar un archivo de formato para reorganizar u omitir filas de la tabla. Esto permite personalizar un archivo de formato en un archivo de datos cuyos campos no se asignan directamente a las columnas de la tabla. Para obtener más información, vea los siguientes temas:

Vea también

Referencia

bcp (utilidad)

Conceptos

Usar un archivo de formato para asignar columnas de tabla a campos de un archivo de datos (SQL Server)

Usar un archivo de formato para omitir una columna de tabla (SQL Server)

Usar un archivo de formato para omitir un campo de datos (SQL Server)

Archivos de formato no XML [SQL Server]

XML, archivos de formato (SQL Server)