Usar un archivo de formato para omitir una columna de tabla

Actualizado: 17 de julio de 2006

En este tema se describen los archivos de formato. Se puede utilizar un archivo de formato para omitir la importación de una columna de tabla cuando el campo no existe en el archivo de datos. Un archivo de datos sólo puede contener menos campos que el número de columnas en la tabla si las columnas omitidas tienen un valor nulo y/o contienen un valor predeterminado.

Tabla y archivo de datos de ejemplo

Los siguientes ejemplos requieren una tabla denominada myTestSkipCol en la base de datos de ejemplo AdventureWorks bajo el esquema dbo. Para crear esta tabla, realice lo siguiente:

USE AdventureWorks;
GO
CREATE TABLE myTestSkipCol 
   (
   Col1 smallint,
   Col2 nvarchar(50) NULL,
   Col3 nvarchar(50) not NULL
   );
GO

En los siguientes ejemplos se utiliza un archivo de datos de ejemplo, myTestSkipCol2.dat, que sólo contiene dos campos, aunque la tabla correspondiente contiene tres columnas:

1,DataForColumn3
1,DataForColumn3
1,DataForColumn3

Para realizar importaciones masivas de datos desde myTestSkipCol2.dat en la tabla myTestSkipCol, el archivo de formato debe asignar el primer campo de datos a Col1, el segundo campo a Col3, omitiendo Col2.

Usar un archivo de formato no XML

Puede modificar un archivo de formato no XML para omitir una columna de tabla. Normalmente, esto implica la utilización de la utilidad bcp para crear un archivo de formato no XML predeterminado y la modificación del archivo predeterminado en un editor de textos. El archivo de formato modificado debe asignar cada uno de los campos existentes a su columna de tabla correspondiente e indicar las columnas que se deben omitir. Para modificar un archivo de datos de formato no XML predeterminado existen dos alternativas. Cada alternativa indica que el campo de datos no existe en el archivo de datos y que no se insertará ningún dato en la columna correspondiente de la tabla.

Crear un archivo de formato no XML predeterminado

Este tema utiliza el archivo de formato no XML predeterminado que se creó para la tabla de ejemplo myTestSkipCol mediante el siguiente comando bcp:

bcp AdventureWorks..myTestSkipCol format nul -f myTestSkipCol_Default.fmt -c -T

En el ejemplo anterior se crea un archivo de formato no XML, myTestSkipCol_Default.fmt. Este formato de archivo se denomina archivo de formato predeterminado porque es el formulario generado por bcp. Normalmente, un archivo de formato predeterminado describe una correspondencia uno a uno entre los campos de archivo de datos y las columnas de la tabla.

ms179250.security(es-es,SQL.90).gifNota de seguridad:
Es posible que deba especificar el nombre de la instancia de servidor a la que se va a conectar. También es posible que deba especificar el nombre de usuario y la contraseña. Para obtener más información, vea bcp (utilidad).

En la siguiente ilustración se muestran los valores de estos archivos de formato predeterminados de ejemplo. La ilustración también muestra el nombre de cada campo de archivo de formato.

archivo predeterminado de formato no XML para myTestSkipCol

[!NOTA] Para obtener más información acerca de los campos de archivo de formato, vea Descripción de los archivos de formato no XML.

Métodos para modificar un archivo de formato no XML

Para omitir una columna de tabla, edite el archivo de formato no XML predeterminado y modifíquelo utilizando uno de los siguientes métodos alternativos:

  • El método preferido consta de tres pasos básicos. Primero, elimine cualquier fila de archivo de formato que describa un campo que no esté en el archivo de datos. A continuación, reduzca el valor "Orden de campo del archivo host" de cada fila de archivo de formato antecedida por una fila eliminada. El objetivo es tener valores "Orden de campo del archivo host" secuenciales, de 1 a n, que reflejen la posición real de cada campo de datos del archivo de datos. Por último, reduzca el valor del campo "Número de columnas" para que se ajuste al número real de campos del archivo de datos.
    El ejemplo siguiente se basa en el archivo de formato predeterminado para la tabla myTestSkipCol, que se creó en "Crear un archivo de formato no XML predeterminado", anteriormente en este tema. Este archivo de formato modificado asigna el primer campo de datos a Col1, omite Col2 y asigna el segundo campo de datos a Col3. La fila para Col2 se ha eliminado. Otras modificaciones se indican en negrita:

    9.0
    2
    1       SQLCHAR       0       7       "\t"     1     Col1         ""
    2       SQLCHAR       0       100     "\r\n"   3     Col3         SQL_Latin1_General_CP1_CI_AS
    
  • Como alternativa, para omitir una columna de tabla, puede modificar la definición de la fila de archivo de formato que corresponda a la columna de tabla. En esta fila de archivo de formato, los valores "longitud de prefijo", "longitud de datos del archivo host" y "orden de las columnas del servidor" deben establecerse en 0. Además, los campos "terminador" e "intercalación de columna" deben configurarse con el valor "" (NULL).
    El valor "nombre de columna de servidor" requiere una cadena que no esté en blanco, aunque el nombre de columna real no es necesario. Los campos de formato restantes requieren los valores predeterminados.
    El siguiente ejemplo también se deriva del archivo de formato predeterminado para la tabla myTestSkipCol. Los valores que deben ser 0 o NULL se indican en negrita.

    9.0
    3
    1       SQLCHAR       0       7       "\t"     1     Col1         ""
    2       SQLCHAR       0       0      ""     0     Col2         ""
    3       SQLCHAR       0       100     "\r\n"   3     Col3         SQL_Latin1_General_CP1_CI_AS
    

Ejemplos

Los siguientes ejemplos también se basan en la tabla de ejemplo myTestSkipCol y el archivo de datos de ejemplo myTestSkipCol2.dat que se crearon en "Tabla y archivo de datos de ejemplo" anteriormente en este tema.

Usar BULK INSERT

Este ejemplo funciona con cualquiera de los archivos de formato no XML modificados que se crearon en "Métodos para modificar un archivo de formato no XML" anteriormente en este tema. En este ejemplo, el archivo de formato modificado se llama C:\myTestSkipCol2.fmt. 2Para utilizar BULK INSERT a fin de importar de forma masiva el archivo de datos myTestSkipCol2.dat, en el Editor de consultas de SQL Server Management Studio, ejecute el siguiente código:

USE AdventureWorks;
GO
BULK INSERT myTestSkipCol 
   FROM 'C:\myTestSkipCol2.dat' 
   WITH (FORMATFILE = 'C:\myTestSkipCol2.fmt');
GO
SELECT * FROM myTestSkipCol;
GO

Usar un archivo de formato XML

Con un archivo de formato XML, no se puede omitir una columna cuando se importa directamente a una tabla mediante el comando bcp o una instrucción BULK INSERT. Sin embargo, se puede importar en todas las columnas de una tabla, excepto en la última columna. Si se tienen que omitir todas las columnas excepto la última, se debe crear una vista de la tabla de destino que contenga únicamente las columnas incluidas en el archivo de datos. De esta forma, se puede realizar una importación masiva de los datos de ese archivo en la vista.

Para utilizar un archivo de formato XML para omitir una columna de la tabla mediante OPENROWSET(BULK...), debe proporcionar una lista explícita de las columnas en la lista de selección y en la tabla de destino de la siguiente manera:

INSERT ...<column_list> SELECT <column_list> FROM OPENROWSET(BULK...)

Crear un archivo de formato XML predeterminado

Los ejemplos de archivos de formato modificado se basan en la tabla myTestSkipCol y el archivo de datos de ejemplo que se crearon en "Tabla y archivo de datos de ejemplo" anteriormente en este tema. El siguiente comando bcp crea un archivo de formato XML predeterminado para la tabla myTestSkipCol:

bcp AdventureWorks..myTestSkipCol format nul -f myTestSkipCol_Default.xml -c -x -T

El archivo de formato no XML predeterminado resultante describe una correspondencia uno a uno entre los archivos de campos de datos y las columnas de la tabla, de esta forma:

<?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="\t" MAX_LENGTH="7"/>
  <FIELD ID="2" xsi:type="CharTerm" TERMINATOR="\t" MAX_LENGTH="100" COLLATION="SQL_Latin1_General_CP1_CI_AS"/>
  <FIELD ID="3" xsi:type="CharTerm" TERMINATOR="\r\n" MAX_LENGTH="100" COLLATION="SQL_Latin1_General_CP1_CI_AS"/>
 </RECORD>
 <ROW>
  <COLUMN SOURCE="1" NAME="Col1" xsi:type="SQLSMALLINT"/>
  <COLUMN SOURCE="2" NAME="Col2" xsi:type="SQLNVARCHAR"/>
  <COLUMN SOURCE="3" NAME="Col3" xsi:type="SQLNVARCHAR"/>
 </ROW>
</BCPFORMAT>

[!NOTA] Para obtener información acerca de la estructura de los archivos de formato XML, vea Descripción de los archivos de formato XML.

Ejemplos

Los ejemplos de esta sección utilizan la tabla de ejemplo myTestSkipCol y el archivo de datos de ejemplo myTestSkipCol2.dat que se crearon en "Tabla de ejemplo y archivo de datos" anteriormente en este tema. Para importar datos desde myTestSkipCol2.dat a la tabla myTestSkipCol, los ejemplos utilizan el siguiente archivo de formato XML modificado, myTestSkipCol2-x.xml. Éste se basa en el archivo de formato que se creó en "Crear un archivo de formato XML predeterminado" anteriormente en este tema.

<?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="\r\n" MAX_LENGTH="100" COLLATION="SQL_Latin1_General_CP1_CI_AS"/>
 </RECORD>
 <ROW>
  <COLUMN SOURCE="1" NAME="Col1" xsi:type="SQLSMALLINT"/>
  <COLUMN SOURCE="2" NAME="Col3" xsi:type="SQLNVARCHAR"/>
 </ROW>
</BCPFORMAT>

Usar OPENROWSET(BULK...)

En el siguiente ejemplo se utiliza el proveedor de conjuntos de filas OPENROWSET y el archivo de formato myTestSkipCol2.xml. En el ejemplo se importa masivamente el archivo de datos myTestSkipCol2.dat a la tabla myTestSkipCol. La instrucción contiene una lista explícita de las columnas en la lista de selección y también en la tabla de destino, según convenga.

En el Editor de consultas de SQL Server Management Studio, ejecute el siguiente código:

USE AdventureWorks;
GO
INSERT INTO myTestSkipCol
  (Col1,Col3)
    SELECT Col1,Col3
      FROM  OPENROWSET(BULK  'C:\myTestSkipCol2.Dat',
      FORMATFILE='C:\myTestSkipCol2.Xml'  
       ) as t1 ;
GO

Utilizar BULK IMPORT en una vista

En el siguiente ejemplo se crea v_myTestSkipCol en la tabla myTestSkipCol. Esta vista omite la segunda columna de la tabla, Col2. Después, en el ejemplo se usa BULK INSERT para importar el archivo de datos myTestSkipCol2.dat a la vista.

En el Editor de consultas de SQL Server Management Studio, ejecute el siguiente código:

CREATE VIEW v_myTestSkipCol AS
    SELECT Col1,Col3
    FROM myTestSkipCol;
GO

USE AdventureWorks;
GO
BULK INSERT v_myTestSkipCol
FROM 'C:\myTestSkipCol2.dat'
WITH (FORMATFILE='C:\myTestSkipCol2.xml');
GO

Vea también

Conceptos

Usar un archivo de formato para omitir un campo de datos
Usar un archivo de formato para asignar columnas de tabla a campos de un archivo de datos
Usar un archivo de formato para importar datos de forma masiva

Otros recursos

bcp (utilidad)
BULK INSERT (Transact-SQL)
OPENROWSET (Transact-SQL)

Ayuda e información

Obtener ayuda sobre SQL Server 2005

Historial de cambios

Versión Historial

17 de julio de 2006

Contenido nuevo:
  • Se agregaron los comandos bcp para crear los archivos de formato de ejemplo.
Contenido modificado:
  • Se actualizaron las siguientes secciones para que puedan utilizarse con la tabla de ejemplo myTestSkipCol:
    • "Crear un archivo de formato no XML predeterminado"
    • "Métodos para modificar un archivo de formato no XML"
    • "Crear un archivo de formato XML predeterminado"