Configurare la cartella in un'attività di copia

Questo articolo illustra come usare l'attività di copia in una pipeline per copiare dati da e in cartella.

Prerequisiti

Per copiare dati da Cartella, è necessario configurare un gateway dati locale. Per altre informazioni, vedere Come accedere alle origini dati locali in Data Factory.

Formato supportato

Il connettore Folder supporta i formati di file seguenti. Per impostazioni basate sui formati, fare riferimento ai singoli articoli.

Formati supportati dall'origine

• Formato Avro
• Formato binario
• Formato di testo delimitato
• Excel
• Formato JSON
• Formato ORC
• Formato Parquet
• Formato XML

Formati supportati dalla destinazione

• Formato Avro
• Formato binario
• Formato di testo delimitato
• Formato JSON
• Formato ORC
• Formato Parquet

Configurazione supportata

Per la configurazione di ogni scheda nell'attività di copia, vai rispettivamente alle sezioni seguenti.

• General
• Fonte
• Destination
• Mapping
• Impostazioni

Generali

Fare riferimento alle indicazioni generali sulle impostazioni per configurare la scheda Impostazioni generali .

origine

Le proprietà seguenti sono supportate per Folder nella scheda Origine di un'attività di copia.

Le proprietà seguenti sono necessarie:

• Connessione: selezionare una connessione cartella dall'elenco delle connessioni. Se non esiste alcuna connessione, creare una nuova connessione alla cartella.

• Tipo di percorso file: è possibile scegliere Percorso di file, Filtro file, Percorso file con caratteri jolly o Elenco di file come tipo di percorso del file. La configurazione per ogni impostazione è:

  • Percorso file: selezionare Sfoglia per scegliere il file che si vuole copiare o compilare manualmente il percorso.

  • Filtro file: filtro nativo lato server di file, che offre prestazioni migliori rispetto a un filtro con caratteri jolly.

    • Percorso cartella: specificare il percorso della cartella.
    • Filtro file: usare * per trovare la corrispondenza con zero o più caratteri e ? per trovare la corrispondenza con zero o un singolo carattere. Per altre informazioni sulla sintassi e sulle note della sezione Osservazioni , vedere questa sezione.

  • Percorso del file con caratteri jolly: Specificare i percorsi con caratteri jolly.

    • Percorsi jolly: specificare il percorso della cartella o del file con caratteri jolly per filtrare cartelle o file di origine.

      I caratteri jolly consentiti sono: * (corrispondenza di zero o più caratteri) e ? (corrispondenza di zero caratteri o di un carattere singolo). Utilizza ^ per eseguire l'escape se il nome della cartella contiene caratteri jolly o il carattere di escape specificato all'interno.

      • Percorso della cartella con caratteri jolly: specificare il percorso della cartella con caratteri jolly per filtrare le cartelle di origine.

      • Nome file con caratteri jolly: specificare il nome del file con caratteri jolly nel percorso della cartella specificato (o percorso della cartella con caratteri jolly) per filtrare i file di origine.

  • Elenco di file: indica che si vuole copiare un determinato set di file.

    • Percorso cartella: specificare il percorso della cartella.
    • Percorso per la lista di file: Indica un file di testo che include un elenco di file da copiare, con un file per riga, che rappresenta il percorso relativo del file configurato.

• Formato file: selezionare il formato di file applicato dall'elenco a discesa. Selezionare Impostazioni per configurare il formato di file. Per le impostazioni di formati di file diversi, vedere gli articoli in Formato supportato.

Le proprietà seguenti sono facoltative:

• Ricorsivamente: specificare se i dati vengono letti in modo ricorsivo dalle sottocartelle o solo dalla cartella specificata. Questa proprietà è selezionata per impostazione predefinita e non si applica quando si configura l'elenco di file.
• Elimina file dopo il completamento: indica se i file binari vengono eliminati dall'archivio di origine dopo il corretto spostamento nell'archivio di destinazione. L'eliminazione dei file avviene per file. Questa proprietà è valida solo nello scenario di copia dei file binari.

Sotto Avanzate, è possibile specificare i campi seguenti:

• Filtro in base all'ultima modifica: i file vengono filtrati in base alle date dell'ultima modifica. Questa proprietà non si applica quando si configura il tipo di percorso del file come Elenco di file.

  • Ora di inizio (UTC): i file vengono selezionati se l'ora dell'ultima modifica è maggiore o uguale all'ora configurata.

  • Ora di fine (UTC): i file vengono selezionati se l'ora dell'ultima modifica è inferiore all'ora configurata.

  Quando l'ora di inizio (UTC) ha un valore datetime ma l'ora di fine (UTC) è NULL, significa che verranno selezionati i file il cui ultimo attributo modificato è maggiore o uguale al valore datetime. Quando l'ora di fine (UTC) ha un valore datetime, ma ora di inizio (UTC) è NULL, significa che i file il cui ultimo attributo modificato è minore del valore datetime verrà selezionato. Le proprietà possono essere NULL, il che significa che ai dati non verrà applicato alcun filtro sugli attributi del file.

• Abilita l'individuazione della partizione: specificare se analizzare le partizioni dal percorso del file e aggiungerle come colonne di origine aggiuntive. Non è selezionata per impostazione predefinita e non è supportata quando si usa il formato di file binario.

  • Percorso radice della partizione: quando l'individuazione delle partizioni è abilitata, specificare il percorso radice assoluto per leggere le cartelle partizionate come colonne di dati.

    Se ciò non è specificato, per impostazione predefinita,

    • Quando si usa il percorso dei file o l'elenco dei file sull'origine, il percorso principale della partizione è il percorso configurato.
    • Quando si usa il filtro di cartelle con wildcard, il percorso radice della partizione corrisponde al sotto-percorso che precede il primo wildcard.

• Numero massimo di connessioni simultanee: questa proprietà indica il limite massimo di connessioni contemporanee stabilite all'archivio dati durante l'esecuzione dell'attività. Specificare un valore solo quando si desidera limitare le connessioni simultanee.

Destinazione

Le proprietà seguenti sono supportate per Folder nella scheda Destinazione di un'attività di copia.

Le proprietà seguenti sono necessarie:

• Connessione: selezionare una connessione cartella dall'elenco delle connessioni. Se non esiste alcuna connessione, creare una nuova connessione di cartella.

• Percorso file: selezionare Sfoglia per scegliere il file che si vuole copiare o compilare manualmente il percorso.

• Formato file: selezionare il formato di file applicato dall'elenco a discesa. Selezionare Impostazioni per configurare il formato di file. Per le impostazioni di formati di file diversi, vedere gli articoli in Formato supportato.

Le proprietà seguenti sono facoltative:

Sotto Avanzate, è possibile specificare i campi seguenti:

• Comportamento di copia: si definisce comportamento di copia quando l'origine è costituita da file di un archivio dati basato su file. È possibile scegliere un comportamento dall'elenco a discesa.

  • - FlattenHierarchy: tutti i file della cartella di origine si trovano nel primo livello della cartella di destinazione. I nomi dei file di destinazione vengono generati automaticamente.
  • Unire i file: unisce tutti i file della cartella di origine in un solo file. Se si specifica il nome di file, il nome del file unito sarà il nome specificato. In caso contrario, verrà usato un nome di file generato automaticamente.
  • Mantieni gerarchia (impostazione predefinita): mantiene la gerarchia di file nella cartella di destinazione. Il percorso relativo del file di origine nella cartella di origine è identico al percorso relativo del file di destinazione nella cartella di destinazione.

• Connessioni massime simultanee: il limite massimo di connessioni simultanee stabilite all'archivio dati durante l'esecuzione dell'attività. Specificare un valore solo quando si desidera limitare le connessioni simultanee.

mappatura

Per la configurazione della scheda Mapping, accedere a Configurare i mapping nella scheda Mapping.

Settings

Per la configurazione della scheda Impostazioni, vedere Configurare le altre impostazioni nella scheda Impostazioni.

Riepilogo della tabella

Le tabelle seguenti contengono altre informazioni sull'attività di copia in Cartella.

Informazioni sull'origine

Informazioni sulla destinazione

Contenuti correlati

• Panoramica del connettore delle cartelle