Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
Connessioni API REST
AWS Glue i connettori coprono un'ampia gamma di fonti di dati AWS sia esterne che esterne. Tuttavia, potrebbero esserci sistemi proprietari o piattaforme emergenti che i AWS Glue connettori nativi non supportano. Il connettore AWS Glue REST fornisce un meccanismo per configurare un connettore personalizzato per qualsiasi fonte di dati dotata di un'API basata su REST che funziona quindi allo stesso modo dei connettori supportati nativamente. AWS Glue Questa funzionalità riduce al minimo la necessità di creare librerie personalizzate o script ETL per accedere a queste fonti di dati.
Per abilitare il connettore API REST, AWS Glue ha introdotto una nuova AWS risorsa: Connection Type. Le seguenti operazioni possono essere utilizzate per gestire la connettività alle fonti di dati basate su API REST:
-
RegisterConnectionType- Registra un tipo di connessione in AWS Glue base alla configurazione fornita. Per la struttura delle richieste, vedere RegisterConnectionType.
-
DeleteConnectionType- Elimina una configurazione del tipo di connessione in AWS Glue. Vedi DeleteConnectionType.
-
DescribeConnectionType- Restituisce tutti i dettagli delle opzioni supportate per un determinato tipo di connessione in AWS Glue. Vedi DescribeConnectionType.
-
ListConnectionTypes- Restituisce un elenco di tipi di connessione con dettagli di alto livello su ciò che è supportato per ogni tipo di AWS Glue connessione. Per informazioni, consulta ListConnectionTypes.
Creazione di un tipo di connessione REST in AWS Glue
Per creare un tipo di connessione REST, utilizza l' AWS CLI AWS SDK o l' AWS API per richiamare l' RegisterConnectionType API. I dettagli di configurazione vengono forniti in base all'API REST a cui ci si connette.
Nota
Le connessioni REST non possono essere create utilizzando la AWS Glue console
Prerequisito
Prima di tentare di configurare il connettore API AWS Glue REST, è necessario acquisire familiarità con il funzionamento interno dell'API REST. È utile disporre della documentazione dell'API REST per l'origine dei dati e di uno strumento per ispezionare la struttura di richiesta/risposta.
È necessario identificare le seguenti proprietà dell'API REST:
-
Meccanismo di autenticazione utilizzato per le chiamate effettuate all'endpoint REST. AWS Glue I connettori API REST supportano: autenticazione di base, OAuth2 - ClientCredentials, OAuth2 - Codice di autorizzazione, OAuth2 - JWT e autenticazione personalizzata.
-
Entità (oggetti dati) che è possibile trasferire tramite l'endpoint REST e i relativi metadati (come nomi di campo e tipi di dati).
-
La struttura di richiesta e risposta HTTP. Questa struttura include il metodo HTTP, l'URL dell'endpoint, le intestazioni, i parametri di query e il formato del corpo della richiesta e del payload della risposta.
-
Lo schema di impaginazione. AWS Glue I connettori API REST supportano due schemi di impaginazione:
cursor-basedeoffset-basedl'impaginazione.
RegisterConnectionType
Registra un login ConnectionType in AWS Glue base alla configurazione fornita. La ConnectionType risorsa è una nuova AWS Glue risorsa che memorizza i dettagli su come le richieste e le risposte vengono interpretate dall'origine dati. Oggi è supportato solo il protocollo REST. Incapsula dettagli sulla fonte dell'API REST come:
-
Proprietà di connessione: definisce BaseUrl la connessione all'API REST e qualsiasi parametro di richiesta aggiuntivo necessario per ricevere input durante. AWS Glue CreateConnection
-
Configurazione dell'autenticazione: definisce come vengono autenticate le richieste all'API REST. Questa configurazione viene utilizzata quando si crea una AWS Glue connessione per il tipo di connessione.
-
Configurazione REST: definisce la configurazione di richiesta e risposta HTTP per leggere i dati dalla fonte dell'API REST. Le seguenti proprietà devono essere configurate a livello globale o di entità:
-
Metodo di richiesta: definisce il metodo HTTP REST.
-
Configurazione della risposta: definisce come deve essere interpretata la risposta dell'API (incluse le posizioni dei record o degli errori nel corpo).
-
Configurazione della paginazione: definisce la strategia utilizzata dall'API REST per l'impaginazione dei record risultanti e il modo in cui le proprietà di impaginazione devono essere inviate/recuperate.
-
Configurazione dell'endpoint di convalida: definisce l'endpoint da chiamare per convalidare una connessione. AWS Glue
-
Configurazioni delle entità: definisce le entità REST supportate dal connettore e il relativo schema.
-
RegisterConnectionType Sintassi della richiesta
Una volta registrato, il tipo di connessione API REST è pronto per essere utilizzato per creare connessioni all'origine dati configurata. Per istruzioni dettagliate, consulta Connessione a REST APIs.
