Come configurare REST in un'attività di copia
Questo articolo illustra come usare l'attività di copia nella pipeline di dati per copiare dati da e in un endpoint REST.
Importante
Microsoft Fabric è attualmente disponibile in ANTEPRIMA. Queste informazioni si riferiscono a un prodotto in versione preliminare che può essere modificato in modo sostanziale prima del rilascio. Microsoft non fornisce alcuna garanzia, espressa o implicita, rispetto alle informazioni fornite qui. Vedere Azure Data Factory documentazione per il servizio in Azure.
In particolare, questo connettore REST generico supporta:
- Copiare dati da un endpoint REST usando i metodi GET o POST e copiando i 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ì come è o analizzarla usando il mapping dello 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.
Generale
Per Configurazione scheda Generale , passare a Generale.
Source (Sorgente)
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 di connessioni. Se non esiste alcuna connessione, creare una nuova connessione REST selezionando Nuovo.
- Tipo di connessione: selezionare REST.
- URL relativo: URL relativo alla risorsa che contiene i dati. Quando questa proprietà non viene specificata, viene usato solo l'URL specificato nella definizione di connessione. Il connettore HTTP copia i dati dall'URL combinato:
[URL specified in connection]/[relative URL specified].
In Avanzate è possibile specificare i campi seguenti:
Metodo di richiesta: metodo HTTP. I valori consentiti sono GET (impostazione predefinita) e POST.
Timeout della richiesta: timeout (valore di intervallo di tempo) per la richiesta HTTP per ottenere 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 di richiesta deve essere un numero compreso tra [10, 60000].
Intestazioni aggiuntive: intestazioni di richiesta HTTP aggiuntive.
Regole di paginazione: regole di impaginazione per comporre le richieste di pagina successiva. Per informazioni dettagliate, vedere la sezione supporto per la paginazione .
Colonne aggiuntive: aggiungere altre colonne di dati per archiviare il percorso relativo o il valore statico dei file di origine. L'espressione è supportata per quest'ultima.
Destination
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.
- 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: URL relativo alla risorsa che contiene i dati. Quando questa proprietà non viene specificata, viene usato solo l'URL specificato nella definizione di connessione. Il connettore HTTP copia i dati dall'URL combinato:
[URL specified in connection]/[relative URL specified].
In Avanzate è possibile specificare i campi seguenti:
Metodo di richiesta: metodo HTTP. I valori consentiti sono POST (impostazione predefinita), PUT e PATCH.
Timeout della richiesta: timeout (valore di intervallo di tempo) per la richiesta HTTP per ottenere una risposta. Questo valore è il timeout per ottenere una risposta, non il timeout 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 di richiesta 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: tipo di compressione HTTP da usare durante l'invio di dati con livello di compressione ottimale. I valori consentiti sono None e GZip.
Intestazioni aggiuntive: intestazioni di richiesta HTTP aggiuntive.
Mapping
Per la configurazione della scheda Mapping , passare a Configurare i mapping nella scheda mapping. Il mapping non è supportato quando sia l'origine che la destinazione sono dati gerarchici.
Impostazioni
Per la configurazione della scheda Impostazioni , passare a Configura le altre impostazioni nella scheda Impostazioni.
Riepilogo tabella
Le tabelle seguenti contengono altre informazioni sull'attività di copia in REST.
Informazioni sull'origine.
| Nome | Descrizione | Valore | Necessario | Proprietà dello script JSON |
|---|---|---|---|---|
| Tipo di archivio dati | Tipo di archivio dati. | • Area di lavoro • Esterno • Set di dati di esempio |
Sì | type |
| Connection | Connessione all'archivio dati di origine. | <la connessione> | Sì | connection |
| Tipo di connessione | Tipo di connessione. Selezionare REST. | REST | Sì | - tipo: RestResource |
| URL relativo | URL relativo della risorsa che contiene i dati. Quando questa proprietà non viene specificata, viene usato solo l'URL specificato nella definizione di connessione. Il connettore HTTP copia i dati dall'URL combinato: [URL specified in connection]/[relative URL specified]. |
<l'URL relativo> | No | relativeUrl |
| Metodo di richiesta | Metodo HTTP. I valori consentiti sono GET (impostazione predefinita) e POST. | • GET • POST |
No | requestMethod |
| Timeout richiesta | Timeout (valore di intervallo di tempo) per la richiesta HTTP per ottenere 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) | Intervallo di tempo tra richieste diverse per più pagine in millisecondi. Il valore dell'intervallo di richiesta deve essere un numero compreso tra [10, 60000]. | [10, 60000] | No | requestInterval |
| Intestazioni aggiuntive | Intestazioni richiesta HTTP aggiuntive. | <intestazioni aggiuntive> | No | additionalHeaders |
| Regole di paginazione | Regole di paginazione per comporre le richieste di pagina successive. Per informazioni dettagliate, vedere la sezione supporto per la paginazione . | Vai alla paginazione | No | paginationRules |
| Colonne aggiuntive | Aggiungere altre colonne di dati al percorso relativo dei file di origine dell'archivio o al valore statico. L'espressione è supportata per quest'ultima. | • Name •Valore |
No | additionalColumns: •Nome •Valore |
Informazioni sulla destinazione
| Nome | Descrizione | Valore | Necessario | Proprietà dello script JSON |
|---|---|---|---|---|
| Tipo di archivio dati | Tipo di archivio dati. | • Area di lavoro • Esterno |
Sì | type |
| Connection | Connessione all'archivio dati di origine. | <la connessione> | Sì | connection |
| Tipo di connessione | Tipo di connessione. Selezionare REST. | REST | Sì | - tipo: RestResource |
| URL relativo | URL relativo della risorsa che contiene i dati. Quando questa proprietà non viene specificata, viene usato solo l'URL specificato nella definizione di connessione. Il connettore HTTP copia i dati dall'URL combinato: [URL specified in connection]/[relative URL specified]. |
<l'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 intervallo di tempo) per la richiesta HTTP per ottenere 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) | Intervallo di tempo tra richieste diverse per più pagine in millisecondi. Il valore intervallo di richiesta deve essere un numero compreso tra [10, 60000]. | [10, 60000] | No | requestInterval |
| Dimensioni batch di scrittura | Numero di record da scrivere nella destinazione REST per batch. Il valore predefinito è 10000. | <numero di righe> (intero) |
No | writeBatchSize |
| Tipo di compressione Http | 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. | <intestazioni aggiuntive> | No | additionalHeaders |