Cargar archivos en FileTables

  • Artículo

Se aplica a:SQL Server

Describe cómo se cargan o migran archivos en las FileTables.

Cargar o migrar archivos en una FileTable

El método que elija para cargar o migrar archivos en una FileTable dependerá del lugar en el que estén almacenados actualmente los archivos.

Ubicación actual de los archivos Opciones de migración
Los archivos están almacenados actualmente en el sistema de archivos.

SQL Server no tiene conocimiento de los archivos.		 Dado que una FileTable aparece como carpeta en el sistema de archivos de Windows, puede cargar archivos fácilmente en una nueva FileTable mediante cualquiera de los métodos disponibles para mover o copiar archivos. Estos métodos incluyen el Explorador de Windows, las opciones de la línea de comandos (incluidas xcopy y robocopy), así como aplicaciones o scripts personalizados.

No puede convertir una carpeta existente en una FileTable.
Los archivos están almacenados actualmente en el sistema de archivos.

SQL Server incluye una tabla de metadatos que contiene punteros a los archivos.		 El primer paso es mover o copiar los archivos mediante uno de los métodos anteriores.

El segundo paso es actualizar la tabla de metadatos existente para que señale a la nueva ubicación de los archivos.

Para más información, vea Migrar archivos desde el sistema de archivos a una FileTable más adelante en este artículo.

Cargar archivos en una FileTable

Puede usar estos métodos para cargar archivos en una FileTable:

  • Arrastrar y colocar los archivos desde las carpetas de origen hasta la nueva carpeta de FileTable del Explorador de Windows.

  • Usar opciones de la línea de comandos, como MOVE, COPY, XCOPY o ROBOCOPY, desde el símbolo del sistema o en un archivo o un script por lotes.

  • Escribir una aplicación personalizada para mover o copiar los archivos en C# o Visual Basic.NET. Llamar a métodos del espacio de nombres System.IO.

Migrar archivos desde el sistema de archivos a una FileTable

En este escenario, los archivos se almacenan en el sistema de archivos y dispone de una tabla de metadatos en SQL Server que contiene indicadores a los archivos. Puede mover los archivos a una FileTable y reemplazar después la ruta de acceso UNC original de cada archivo de los metadatos por la ruta de acceso UNC de la FileTable. La función GetPathLocator (Transact-SQL) le ayuda a lograr este objetivo.

En este ejemplo, se supone que hay una tabla de base de datos existente, PhotoMetadata, que contiene datos sobre fotografías. Esta tabla tiene una columna UNCPath de tipo varchar(512) que contiene la ruta de acceso UNC real de un archivo .jpg.

Debe realizar las siguientes acciones para migrar los archivos de imagen desde el sistema de archivos a una FileTable:

  1. Cree una nueva FileTable para almacenar los archivos. En este ejemplo se usa el nombre de tabla, dbo.PhotoTable, pero no se muestra el código para crearla.

  2. Usar xcopy o una herramienta similar para copiar los archivos .jpg, con su estructura de directorio, en el directorio raíz de la FileTable.

  3. Corregir los metadatos de la tabla PhotoMetadata, mediante el uso de código parecido a este:

--  Add a path locator column to the PhotoMetadata table.  
ALTER TABLE PhotoMetadata ADD pathlocator hierarchyid;  
  
-- Get the root path of the Photo directory on the File Server.  
DECLARE @UNCPathRoot varchar(100) = '\\RemoteShare\Photographs';  
  
-- Get the root path of the FileTable.  
DECLARE @FileTableRoot varchar(1000);  
SELECT @FileTableRoot = FileTableRootPath('dbo.PhotoTable');  
  
-- Update the PhotoMetadata table.  
  
-- Replace the File Server UNC path with the FileTable path.  
UPDATE PhotoMetadata  
    SET UNCPath = REPLACE(UNCPath, @UNCPathRoot, @FileTableRoot);  
  
-- Update the pathlocator column to contain the pathlocator IDs from the FileTable.  
UPDATE PhotoMetadata  
    SET pathlocator = GetPathLocator(UNCPath);

Cargar de forma masiva archivos en una FileTable

Una FileTable se comporta como una tabla normal en las operaciones masivas, con los requisitos siguientes:

Una FileTable tiene restricciones definidas por el sistema que garantizan que se mantiene la integridad del espacio de nombres de archivo o de directorio. Estas restricciones deben comprobarse en los datos cargados de forma masiva en la FileTable. Como algunas operaciones de inserción masiva permiten omitir las restricciones de tabla, se aplicarán los siguientes requisitos.

  • Las operaciones de carga masiva que aplican restricciones pueden ejecutarse en una FileTable exactamente igual que en cualquier otra tabla. Esta categoría incluye las siguientes operaciones:

    • bcp con la cláusula CHECK_CONSTRAINTS.

    • BULK INSERT con la cláusula CHECK_CONSTRAINTS.

    • INSERT INTO ... SELECT * FROM OPENROWSET(BULK ...) sin la cláusula IGNORE_CONSTRAINTS.

  • Las operaciones de carga masiva que no aplican restricciones no se ejecutarán correctamente a menos que se deshabiliten las restricciones definidas por el sistema para la FileTable. Esta categoría incluye las siguientes operaciones:

    • bcp sin la cláusula CHECK_CONSTRAINTS.

    • BULK INSERT sin la cláusula CHECK_CONSTRAINTS.

    • INSERT INTO ... SELECT * FROM OPENROWSET(BULK ...) con la cláusula IGNORE_CONSTRAINTS.

Realizar la carga masiva de archivos en una FileTable

Puede usar varios métodos para cargar de forma masiva archivos en una FileTable:

  • bcp

    • Se llama con la cláusula CHECK_CONSTRAINTS .

    • Se deshabilita el espacio de nombres de FileTable y se llama sin la cláusula CHECK_CONSTRAINTS . A continuación, se vuelve a habilitar el espacio de nombres de la FileTable.

  • BULK INSERT

    • Se llama con la cláusula CHECK_CONSTRAINTS .

    • Se deshabilita el espacio de nombres de FileTable y se llama sin la cláusula CHECK_CONSTRAINTS . A continuación, se vuelve a habilitar el espacio de nombres de la FileTable.

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

    • Se llama con la cláusula IGNORE_CONSTRAINTS .

    • Se deshabilita el espacio de nombres de FileTable y se llama sin la cláusula IGNORE_CONSTRAINTS . A continuación, se vuelve a habilitar el espacio de nombres de la FileTable.

Para obtener más información sobre cómo deshabilitar las restricciones de FileTable, vea Administrar FileTables.

Deshabilitar restricciones de FileTable para carga masiva

Para realizar la carga masiva de datos en una FileTable sin la sobrecarga que supone la aplicación de restricciones definidas por el sistema, puede deshabilitar temporalmente estas restricciones. Para obtener más información, vea Administrar FileTables.

Consulte también

Obtener acceso a FileTables con Transact-SQL
Obtener acceso a FileTables con API de entrada-salida de archivo