Configurare REST in un'attività di copia
Questo articolo descrive come usare l'attività Copy in Azure Data Factory per copiare dati da e verso un endpoint REST.
In particolare, questo connettore REST generico supporta:
- Copia di dati da un endpoint REST usando i metodi di GET o POST e copia di dati in un endpoint REST usando i metodi POST, PUT o PATCH.
- La paginazione nelle API REST.
- Per REST come origine, copiare la risposta JSON REST così com'è o analizzarla usando mapping schema. È supportato solo il payload della risposta in JSON.
Configurazione supportata
Per la configurazione di ogni scheda in un'attività di copia, passare rispettivamente alle sezioni seguenti.
Generali
Per configurazione della scheda Generale, passare a Generale.
Origine
Le proprietà seguenti sono supportate per REST nella scheda Origine di un'attività di copia.
Sono necessarie le prime tre proprietà seguenti:
- Tipo di archivio dati: selezionare Esterno.
- Connessione: selezionare una connessione REST dall'elenco delle connessioni. Se non esiste alcuna connessione, creare una nuova connessione REST selezionando Nuovo.
- Tipo di connessione: selezionare REST.
- URL relativo: un URL relativo della risorsa che contiene i dati. Quando questa proprietà non è specificata, viene usato solo l'URL indicato nella definizione del servizio collegato. Il connettore HTTP copia dati dall'URL combinato:
[URL specified in connection]/[relative URL specified].
Sotto Avanzate, è possibile specificare i campi seguenti:
Metodo richiesta: Metodo della richiesta HTTP. I valori consentiti sono GET (predefinito) e POST.
Timeout richiesto: Timeout (valore di TimeSpan) durante il quale la richiesta HTTP attende una risposta. Si tratta del timeout per ottenere una risposta, non per leggere i dati della risposta. Il valore predefinito è 00:01:40.
Intervallo di richiesta (ms): intervallo tra richieste diverse per più pagine in millisecondi. Il valore dell’intervallo tra le richieste deve essere un numero compreso tra [10, 60000].
Intestazioni aggiuntive: intestazioni di richiesta HTTP aggiuntive.
Regole di paginazione: Le regole di paginazione per comporre le richieste di pagina successive. Per informazioni dettagliate, vedere la sezione il supporto della paginazione.
Colonne aggiuntive: aggiungere altre colonne di dati per archiviare il percorso relativo o il valore statico dei file di origine. Se si usa un valore statico, è possibile usare espressioni personalizzate per generarla.
Destinazione
Le proprietà seguenti sono supportate per REST nella scheda Destinazione di un'attività di copia.
Sono necessarie le prime tre proprietà seguenti:
- Tipo di archivio dati: selezionare Esterno.
- Collegamento: selezionare un collegamento REST sicuro dall'elenco dei collegamenti. Se non esiste alcuna connessione, creare una nuova connessione REST selezionando Nuovo.
- Tipo di connessione: selezionare REST.
- URL relativo: un URL relativo della risorsa che contiene i dati. Quando questa proprietà non è specificata, viene usato solo l'URL indicato nella definizione del servizio collegato. Il connettore HTTP copia dati dall'URL combinato:
[URL specified in connection]/[relative URL specified].
Sotto Avanzate, è possibile specificare i campi seguenti:
Metodo richiesta: Metodo della richiesta HTTP. I valori consentiti sono POST (impostazione predefinita), PUT e PATCH.
Timeout richiesto: Timeout (valore di TimeSpan) durante il quale la richiesta HTTP attende una risposta. Questo valore è il timeout per ottenere una risposta, non per scrivere i dati. Il valore predefinito è 00:01:40.
Intervallo di richiesta (ms): intervallo tra richieste diverse per più pagine in millisecondi. Il valore dell’intervallo tra le richieste deve essere un numero compreso tra [10, 60000].
Dimensioni batch di scrittura: numero di record da scrivere nella destinazione REST per batch. Il valore predefinito è 10000.
Tipo di compressione HTTP: Il tipo di compressione HTTP da usare durante l'invio di dati con livello di compressione ottimale. I valori consentiti sono nessuno e gzip.
Intestazioni aggiuntive: intestazioni di richiesta HTTP aggiuntive.
Mapping
Per la configurazione della scheda Mapping, vedere Configurare i mapping nella scheda Mapping. Il mapping non è supportato quando sia l'origine che la destinazione sono dati gerarchici.
Impostazione
Per la configurazione della scheda Impostazioni, vedere Configurare le altre impostazioni nella scheda Impostazioni.
Tabella di riepilogo
Le tabelle seguenti contengono altre informazioni sull'attività di copia in REST.
Informazioni sull'origine
| Nome | Descrizione | valore | Richiesto | Proprietà script JSON |
|---|---|---|---|---|
| Tipo di archivio dati | Tipo di archivio dati. | • Area di lavoro personale • Esterno • Set di dati di esempio |
Sì | type |
| Connessione | Connessione all'archivio dei dati di origine. | <Connessione personale> | Sì | connection |
| Tipo di connessione | Il tuo tipo di connessione. Selezionare REST. | REST | Sì | type: RestResource |
| URL relativo | URL relativo della risorsa che contiene i dati. Quando questa proprietà non è specificata, viene usato solo l'URL indicato nella definizione del servizio collegato. Il connettore HTTP copia dati dall'URL combinato: [URL specified in connection]/[relative URL specified]. |
<URL relativo> | No | relativeUrl |
| Metodo di richiesta | Metodo HTTP. I valori consentiti sono GET (predefinito) e POST. | • GET • POST |
No | requestMethod |
| Timeout richiesta | Timeout (valore di TimeSpan) durante il quale la richiesta HTTP attende una risposta. Si tratta del timeout per ottenere una risposta, non per leggere i dati della risposta. Il valore predefinito è 00:01:40. | timespan | No | httpRequestTimeout |
| Intervallo di richiesta (ms) | L’intervallo di tempo tra richieste diverse, in millisecondi. Il valore dell’intervallo tra le richieste deve essere un numero compreso tra [10, 60000]. | [10, 60000] | No | requestInterval |
| Intestazioni aggiuntive | Intestazioni richiesta HTTP aggiuntive. | <le tue intestazioni aggiuntive> | No | additionalHeaders |
| Regole di paginazione | Regole di paginazione per comporre le richieste di pagina successive. Per informazioni dettagliate, vedere la sezione il supporto della paginazione. | Vai alla paginazione | No | paginationRules |
| Colonne aggiuntive | Aggiungere altre colonne di dati al percorso relativo o al valore statico dei file di origine dell'archivio. L'espressione è supportata per quest'ultima. | • Nome • Valore |
No | additionalColumns: • Nome • Valore |
Informazioni sulla destinazione
| Nome | Descrizione | valore | Richiesto | Proprietà script JSON |
|---|---|---|---|---|
| Tipo di archivio dati | Tipo di archivio dati. | • Area di lavoro personale • Esterno |
Sì | type |
| Connessione | Connessione all'archivio dei dati di origine. | <Connessione personale> | Sì | connection |
| Tipo di connessione | Il tuo tipo di connessione. Selezionare REST. | REST | Sì | type: RestResource |
| URL relativo | URL relativo della risorsa che contiene i dati. Quando questa proprietà non è specificata, viene usato solo l'URL indicato nella definizione del servizio collegato. Il connettore HTTP copia dati dall'URL combinato: [URL specified in connection]/[relative URL specified]. |
<URL relativo> | No | relativeUrl |
| Metodo di richiesta | Metodo HTTP. I valori consentiti sono POST (impostazione predefinita), PUT e PATCH. | • POST • GET • PATCH |
No | requestMethod |
| Timeout richiesta | Timeout (valore di TimeSpan) durante il quale la richiesta HTTP attende una risposta. Si tratta del timeout per ottenere una risposta, non per leggere i dati della risposta. Il valore predefinito è 00:01:40. | timespan | No | httpRequestTimeout |
| Intervallo di richiesta (ms) | L’intervallo di tempo tra richieste diverse, in millisecondi. Il valore dell’intervallo tra le richieste deve essere un numero compreso tra [10, 60000]. | [10, 60000] | No | requestInterval |
| Dimensioni batch di scrittura | Numero di record per scrivere nel sink REST per batch. Il valore predefinito è 10000. | <Numero di righe> (integer) |
No | writeBatchSize |
| Tipo di compressione | Tipo di compressione HTTP da usare durante l'invio di dati con livello di compressione ottimale. I valori consentiti sono nessuno e gzip. | • Nessuno • GZip |
No | httpCompressionType |
| Intestazioni aggiuntive | Intestazioni richiesta HTTP aggiuntive. | <le tue intestazioni aggiuntive> | No | additionalHeaders |