Destino de archivo raw

Se aplica a:SQL Server SSIS Integration Runtime en Azure Data Factory

El destino de archivo sin formato escribe datos sin procesar en un archivo. Como el formato de los datos es nativo del destino, los datos no requieren traducción y requieren muy poco análisis. Esto significa que el destino de archivo sin formato puede escribir datos más rápidamente que otros destinos, como el destino de archivo plano o los destinos de OLE DB.

Además de escribir datos sin procesar en un archivo, puede utilizar el destino de archivo sin formato para generar un archivo sin formato vacío que contenga solo las columnas (archivo solo para metadatos), sin tener que ejecutar el paquete. El origen de archivo sin formato se usa para recuperar datos sin formato escritos previamente por el destino. También puede apuntar el origen del archivo Raw al archivo de solo metadatos.

El formato de archivo RAW contiene información de clasificación. El destino de archivo sin procesar guarda toda la información de ordenación, incluidos los indicadores de comparación de las columnas de texto. El origen Archivo sin formato lee y respeta la información de ordenación. Tiene la opción de configurar el origen de archivo sin formato para omitir los marcas de orden en el archivo; para ello use el Editor avanzado. Para obtener más información acerca de las marcas de comparación, vea Comparing String Data.

Puede configurar el destino de archivo sin procesar de las siguientes maneras:

  • Especifique un modo de acceso que corresponda al nombre del archivo o a una variable que contenga el nombre del archivo en el que el destino Archivo sin formato escribe.

  • Indique si el destino de archivo sin procesar anexa datos a un archivo existente con el mismo nombre o crea un archivo nuevo.

El destino de archivo sin procesar se utiliza frecuentemente para escribir resultados intermedios de datos parcialmente procesados entre ejecuciones de paquetes. Almacenar datos sin procesar significa que los datos pueden leerse rápidamente mediante un origen de archivo raw y transformarse posteriormente antes de cargarlos en su destino final. Por ejemplo, un paquete puede ejecutarse varias veces y cada vez puede escribir datos sin procesar en los archivos. Posteriormente, otro paquete puede usar el origen Raw File para leer cada archivo, usar una transformación Union All para combinar los datos en un único conjunto de datos y, después, aplicar transformaciones adicionales que resuman los datos antes de cargarlos en su destino final, como una tabla de SQL Server.

Nota

El destino de archivo sin formato admite datos NULL pero no admite datos de objetos binarios grandes (BLOB).

Nota

El destino de archivo sin formato no usa un administrador de conexiones.

Este origen tiene una entrada normal. No admite una salida de error.

Opciones de anexar y nuevo archivo

La propiedad WriteOption incluye opciones para anexar datos a un archivo existente o para crear un archivo.

En la tabla siguiente se describen las opciones disponibles para la propiedad WriteOption.

Opción Descripción
Anexar Anexa datos a un archivo existente. Los metadatos de los datos anexados deben coincidir con el formato del archivo.
Crear siempre Crea siempre un nuevo archivo.
Crear una vez Crea un nuevo archivo. Si existe el archivo, el componente genera un error.
Truncar y añadir Trunca un archivo existente y luego escribe los datos en el archivo. Los metadatos de los datos anexados deben coincidir con el formato del archivo.

Los siguientes elementos son importantes cuando se anexan datos:

  • Añadir datos a un archivo sin formato existente no vuelve a ordenar los datos.

    Debe asegurarse de que las claves ordenadas permanecen en el orden correcto.

  • Anexar datos a un archivo RAW existente no cambia los metadatos del archivo (información de clasificación).

Por ejemplo, un paquete lee los datos ordenados en ProductKey (PK). El flujo de datos del paquete anexa los datos a un archivo sin formato existente. La primera vez que se ejecuta un paquete, se reciben tres filas (PK 1000, 1100, 1200). Ahora, el archivo sin formato contiene los datos siguientes.

  • 1000, productoA

  • 1100, productoB

  • 1200, productoC

La segunda vez que se ejecuta el paquete, se reciben dos filas nuevas (PK 1001, 1300). El archivo sin procesar ahora contiene los siguientes datos.

  • 1000, productoA

  • 1100, productoB

  • 1200, productoC

  • 1001, productoD

  • 1300, productoE

Los datos nuevos se añaden al final del archivo bruto, y las claves ordenadas (PK) quedan fuera de orden. Además, la operación de anexar no ha cambiado los metadatos del archivo (información sobre el orden). Si lee el archivo con el origen de archivo sin formato, el componente indica que el archivo todavía está ordenado según PK aunque los datos del archivo ya no estén en el orden correcto.

Para mantener las claves ordenadas en el orden correcto mientras se anexan datos, puede diseñar el flujo de datos del paquete como sigue:

  1. Recupera filas nuevas usando Origen A.

  2. Recupere filas existentes desde RawFile1 con Origen B.

  3. Combine las entradas de Origen A y Origen B mediante la transformación Unión total.

  4. Ordene según PK.

  5. Escriba los datos en RawFile2 mediante el destino Archivo sin formato.

    RawFile1 está bloqueado porque se está leyendo desde el flujo de datos.

  6. Reemplace RawFile1 con RawFile2.

Usar el destino de archivo sin formato en un bucle

Si el flujo de datos que usa el destino de archivo sin formato se encuentra en un bucle, puede resultar conveniente crear el archivo una vez y, después, agregar los datos al archivo cuando se repita el bucle. Para agregar los datos al archivo, los datos agregados deben tener el mismo formato que el archivo existente.

Para crear el archivo en la primera iteración del bucle y, posteriormente, agregar filas en las iteraciones subsiguientes, debe hacer lo siguiente en tiempo de diseño:

  1. Establezca la propiedad WriteOption en CreateOnce o CreateAlways y ejecute una iteración del bucle. Se crea el archivo. Así se garantiza que los metadatos de los datos agregados y del archivo sean iguales.

  2. Restablezca la propiedad WriteOption a Append y establezca la propiedad ValidateExternalMetadata en False.

Si usa la opción TruncateAppend en lugar de la opción Append , truncará las filas que se agregaron en toda iteración anterior y anexará filas nuevas. Con la opción TruncateAppend también es necesario que los datos tengan el mismo formato que el archivo.

Configuración del destino de archivo RAW

Puede establecer propiedades a través del Diseñador de SSIS o mediante programación.

El cuadro de diálogo Editor avanzado indica las propiedades que se pueden establecer mediante programación. Para obtener más información acerca de las propiedades que puede establecer a través del cuadro de diálogo Editor avanzado o mediante programación, haga clic en uno de los temas siguientes:

Para obtener información sobre cómo establecer las propiedades del componente, vea Establecer las propiedades de un componente de flujo de datos.

Editor de destino de archivos sin formato (Página del Administrador de conexiones)

Use el editor de destino de archivos sin formato para configurar el destino de archivo sin formato con el fin de escribir datos sin formato en un archivo.

¿Qué desea hacer?

Abra el editor de destino de archivos sin formato

  1. Agregue el destino de archivo sin procesar a un paquete de Integration Services en SQL Server Data Tools (SSDT).

  2. Haga clic con el botón derecho en el componente y, después, haga clic en Editar.

Establecer opciones en la pestaña Administrador de conexiones

Modo de acceso
Seleccione cómo se especifica el nombre de archivo. Seleccione Nombre de archivo para escribir el nombre de archivo y la ruta de acceso directamente o Nombre de archivo de la variable para especificar una variable que contiene el nombre de archivo.

Nombre de archivo o Nombre de variable
Escriba el nombre y la ruta de acceso del archivo de datos sin procesar, o seleccione la variable que contiene el nombre del archivo.

Opción de escritura
Seleccione el método que va a utilizar para crear y escribir en el archivo.

Generar archivo RAW inicial
Haga clic en el botón para generar un archivo sin formato vacío que contenga solo las columnas (solo archivos de metadatos), sin tener que ejecutar el paquete. El archivo contiene las columnas seleccionadas en la página Columnas: del Editor de destino de archivos sin formato. Puede apuntar el origen del archivo sin formato a este archivo de solo metadatos.

Al hacer clic en Generar archivo sin formato inicial, aparece un cuadro de mensaje. Haga clic en Aceptar para continuar con la creación del archivo. Haga clic en Cancelar para seleccionar otra lista de columnas en la página Columnas: .

Establecer las opciones de la pestaña Columnas

Columnas de entrada disponibles
Seleccione una o varias columnas de entrada para escribir en el archivo sin formato.

Columna de entrada
Una columna de entrada se agrega automáticamente a esta tabla cuando se selecciona en Columnas de entrada disponibles, o puede seleccionar la columna de entrada directamente en esta tabla.

Alias de salida
Especifique un nombre alternativo para usarlo en la columna de salida.

Editor de destino de archivo sin formato (página de columnas)

Use el editor de destino de archivos sin formato para configurar el destino de archivo sin formato con el fin de escribir datos sin formato en un archivo.

¿Qué desea hacer?

Abra el editor de destino de archivos sin formato

  1. Agregue el destino de archivo sin procesar a un paquete de Integration Services en SQL Server Data Tools (SSDT).

  2. Haga clic con el botón derecho en el componente y, después, haga clic en Editar.

Establecer opciones en la pestaña Administrador de conexiones

Modo de acceso
Seleccione cómo se especifica el nombre de archivo. Seleccione Nombre de archivo para escribir el nombre de archivo y la ruta de acceso directamente o Nombre de archivo de la variable para especificar una variable que contiene el nombre de archivo.

Nombre de archivo o Nombre de variable
Escriba el nombre y la ruta de acceso del archivo de datos sin procesar, o seleccione la variable que contiene el nombre del archivo.

Opción de escritura
Seleccione el método que va a utilizar para crear y escribir en el archivo.

Generar archivo RAW inicial
Haga clic en el botón para generar un archivo sin formato vacío que contenga solo las columnas (solo archivos de metadatos), sin tener que ejecutar el paquete. Puede apuntar el origen del archivo raw al archivo que solo contiene metadatos.

Al hacer clic en el botón, aparece una lista de columnas. Puede hacer clic en Cancelar y modificar las columnas, o hacer clic en Aceptar y continuar con la creación del archivo.

Establecer las opciones de la pestaña Columnas

Columnas de entrada disponibles
Seleccione una o varias columnas de entrada para escribir en el archivo sin procesar.

Columna de entrada
Una columna de entrada se agrega automáticamente a esta tabla cuando se selecciona en Columnas de entrada disponibles, o puede seleccionar la columna de entrada directamente en esta tabla.

Alias de salida
Especifique un nombre alternativo para usarlo en la columna de salida.

Contenido relacionado

  • Last updated on