Filtrar los datos transferidos porAWS DataSync - AWS DataSync
Filtrar términos, definiciones y sintaxisExcluir datos de una transferenciaIncluir datos en una transferenciaFiltros de ejemplo

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Filtrar los datos transferidos porAWS DataSync

AWS DataSyncpermite aplicar filtros si solo desea transferir un subconjunto de datos (como archivos, carpetas u objetos específicos).

Por ejemplo, si la ubicación de origen incluye archivos temporales que terminan en.tmp, puede crear un filtro de exclusión que impida que estos archivos lleguen a la ubicación de destino. También puedes usar una combinación de filtros de exclusión e inclusión en la misma tarea.

Filtrar términos, definiciones y sintaxis

Estos son algunos términos y definiciones que se pueden utilizar con el filtrado:

Filtro

La cadena completa que forma un filtro determinado (por ejemplo:*.tmp|*.temp o/folderA|/folderB).

Los filtros se componen de patrones delimitados con un | (barra vertical). No se necesita un delimitador para añadir patrones en la consola, ya que cada patrón se añade por separado.

nota

Los filtros distinguen entre mayúsculas y minúsculas. Por ejemplo, el filtro/folderA no coincidirá/FolderA.

Pattern

Un patrón de un filtro. Por ejemplo,*.tmp es un patrón que forma parte del*.tmp|*.temp filtro.

Carpetas

  • Todos los filtros se expresan con relación a la ruta de la ubicación de origen. Por ejemplo, supongamos que especifica/my_source/ como ruta de origen al crear la ubicación de origen y la tarea y especifica el filtro de inclusión/transfer_this/. En este caso,DataSync transfiere solo el directorio/my_source/transfer_this/ y su contenido.

  • Para especificar una carpeta directamente debajo de la ubicación de origen, incluya una barra diagonal (/) delante del nombre de la carpeta. En el ejemplo anterior, el patrón utiliza /transfer_this, no transfer_this.

  • DataSyncinterpreta los siguientes patrones de la misma manera y hace coincidir tanto la carpeta como su contenido.

    /dir

    /dir/

  • Al transferir datos desde o hacia un bucket de Amazon S3,DataSync trata el/ carácter de la clave del objeto como el equivalente a una carpeta de un sistema de archivos.

Caracteres especiales

A continuación, se muestran los caracteres especiales que se utilizan en los filtros.

Caraces especiales Descripción

* (comodín)

Carácter que representa cero o más caracteres. Por ejemplo, /movies_folder* coincide con /movies_folder y con /movies_folder1.

| (barra vertical)

Carácter que se utiliza como delimitador de patrones. Permite especificar varios patrones distintos que pueden coincidir con el filtro. Por ejemplo, *.tmp|*.temp coincide con los archivos que tienen la extensión tmp o temp.

nota

Este delimitador no es necesario para añadir patrones en la consola, ya que cada patrón se añade en una línea independiente.

\ (barra diagonal invertida)

Carácter que se utiliza para escapar de los caracteres especiales (*, |,\) de un nombre de archivo u objeto.

Es necesario utilizar una barra diagonal invertida doble (\\) cuando un nombre de archivo contiene una barra diagonal invertida. Del mismo modo, \\\\ representa dos barras diagonales invertidas consecutivas en el nombre de un archivo.

Es necesario utilizar una barra diagonal invertida seguida de una barra vertical (\|) cuando un nombre de archivo contiene una barra vertical.

Se omite una barra invertida (\) seguida de cualquier otro carácter o al final de un patrón.

Excluir datos de una transferencia

Los filtros de exclusión definen los archivos, carpetas y objetos que se excluyen al transferir archivos desde una ubicación de origen a una de destino. Puede configurar estos filtros al crear, editar o iniciar una tarea.

Para crear una tarea con un filtro de exclusión en laDataSync consola, especifique una lista de patrones en la sección Configuración de transferencia de datos, en Excluir patrones. Por ejemplo, para excluir las carpetas temporales denominadastemp otmp, puede especificarlas*/temp en el cuadro de texto Excluir patrones, elegir Agregar patrones y, a continuación, especificar*/tmp en el segundo cuadro de texto. Para añadir más patrones al filtro, elija Add pattern (Añadir patrón). Cuando se utilizaAWS Command Line Interface (AWS CLI), se requieren comillas simples (') alrededor del filtro y se usa un | (barra vertical) como delimitador. Para este ejemplo, debe especificar'*/temp |*/tmp'.

Después de crear una tarea, puede editar la configuración de la tarea para añadir o eliminar patrones del filtro de exclusión. Los cambios se aplicarán a future ejecuciones de la tarea.

Al ejecutar una tarea, puede modificar los patrones de filtro de exclusión mediante la opción Comenzar por anulaciones. Los cambios que realice se aplicarán únicamente a esa ejecución de la tarea.

También puede utilizarAWS CLI para crear o modificar o modificar los datashares. En el ejemplo siguiente, se muestra un comando de la CLI de este tipo.

aws datasync create-task 
    --source-location-arn 'arn:aws:datasync:region:account-id:location/location-id'
    --destination-location-arn 'arn:aws:datasync:region:account-id:location/location-id'
    --cloud-watch-log-group-arn 'arn:aws:logs:region:account-id:log-group:your-log-group' 
    --name your-task-name
    --excludes FilterType=SIMPLE_PATTERN,Value='*/temp|*/tmp'
nota

Si está migrando archivos desde unNetApp sistema, le recomendamos que excluya las carpetasNetApp de respaldo especificándolas*/.snapshot como patrón en el filtro de exclusión.

Incluir datos en una transferencia

Los filtros de inclusión definen los archivos, carpetas y objetos que seDataSync transfieren cuando se ejecuta una tarea. Puede configurar los filtros de inclusión al crear, editar o iniciar una tarea.

Para crear una tarea con un filtro de inclusión, elija la opción Archivos y carpetas específicos y, a continuación, especifique una lista de patrones para incluirlos en Incluir patrones.

DataSyncescanea y transfiere solo los archivos y carpetas que coincidan con los filtros de inclusión. Por ejemplo, para incluir un subconjunto de las carpetas de origen, puede especificar/important_folder_1 |/important_folder_2.

Después de crear una tarea, puede editar la configuración de la tarea para añadir o eliminar patrones del filtro de inclusión. Todos los cambios que realice se aplicarán a future ejecuciones de la tarea.

Al ejecutar una tarea, puede modificar los patrones de filtro de inclusión mediante la opción Comenzar por anulaciones. Los cambios que realice se aplicarán únicamente a esa ejecución de la tarea.

También puede utilizarAWS CLI para crear o modificar o modificar los datashares. En el siguiente ejemplo, se muestra el comando de la CLI. Toma nota de las comillas (') que hay alrededor del filtro y de la| barra vertical que se usa como delimitador.

aws datasync start-task-execution 
   --task-arn 'arn:aws:datasync:region:account-id:task/task-id' 
   --includes FilterType=SIMPLE_PATTERN,Value='/important_folder1|/important_folder2'
nota

Los filtros de inclusión admiten el carácter comodín (*) únicamente como el carácter situado más a la derecha de un patrón. Por ejemplo,/documents* |/code* es compatible, pero*.txt no lo es.

Filtros de ejemplo

En los siguientes ejemplos se muestran los datasharesDataSync.

nota

Hay límites en cuanto al número de caracteres que puede utilizar en un filtro. Para obtener más información, consulte DataSynccuotas de tareas.

Excluir algunas carpetas de la ubicación de origen

En algunos casos, puede excluir las carpetas de la ubicación de origen para no copiarlas a la ubicación de destino. Por ejemplo, es posible que tenga o loswork-in-progress datashares. O bien, puede utilizar unNetApp sistema y querer excluir las carpetas de respaldo. En estos casos puede utilizar el siguiente filtro.

*/.snapshot

Para excluir carpetas con contenido similar (como/reports2021 y/reports2022)), puedes usar un filtro de exclusión como el siguiente:

/reports*

Para excluir carpetas en cualquier nivel de la jerarquía de archivos, puede utilizar un filtro de exclusión como el siguiente.

*/folder-to-exclude-1|*/folder-to-exclude-2

Para excluir las carpetas del nivel superior de la ubicación de origen, puede utilizar un filtro de exclusión como el siguiente.

/top-level-folder-to-exclude-1|/top-level-folder-to-exclude-2

Incluye un subconjunto de carpetas en tu ubicación de origen

En algunos casos, la ubicación de origen puede ser un recurso compartido grande y es necesario transferir un subconjunto de las carpetas de la raíz. Para incluir carpetas específicas, comience una ejecución de tarea con un filtro de inclusión similar al siguiente.

/folder-to-transfer/*

Excluir tipos de archivos específicos

Para excluir determinados tipos de archivos de la transferencia, puede crear una ejecución de tarea con un filtro de exclusión como por ejemplo *.temp.

Transfiere los archivos individuales que especifiques

Para transferir una lista de archivos individuales, inicie la ejecución de una tarea con un filtro de inclusión como el siguiente: "/folder/subfolder/file1.txt|/folder/subfolder/file2.txt |/folder/subfolder/file2.txt»