Condividi tramite

Risolvere i problemi del connettore REST in Azure Data Factory e Azure Synapse

  • Articolo

SI APPLICA A: Azure Data Factory Azure Synapse Analytics

Suggerimento

Provare Data Factory in Microsoft Fabric, una soluzione di analisi completa per le aziende. Microsoft Fabric copre tutti gli elementi, dallo spostamento dei dati all'analisi scientifica dei dati, all'analisi in tempo reale, alla business intelligence e alla creazione di report. Scopri come avviare gratuitamente una nuova versione di valutazione .

Questo articolo fornisce suggerimenti per risolvere i problemi comuni con il connettore REST in Azure Data Factory e Azure Synapse.

Codice errore: RestSinkCallFailed

  • Messaggio: Rest Endpoint responded with Failure from server. Check the error from server:%message;

  • Causa: questo errore si verifica quando una data factory o una pipeline di Synapse comunica con l'endpoint REST tramite protocollo HTTP e l'operazione di richiesta non riesce.

  • Raccomandazione: controllare il codice di stato HTTP o il messaggio nel messaggio di errore e correggere il problema del server remoto.

Codice errore: RestSourceCallFailed

  • Messaggio: The HttpStatusCode %statusCode; indicates failure.
Request URL: %requestUri;
Response payload:%payload;

  • Causa: questo errore si verifica quando Azure Data Factory comunica con l'endpoint REST tramite protocollo HTTP e l'operazione di richiesta non riesce.

  • Raccomandazione: controllare il codice di stato HTTP o l'URL della richiesta o il payload della risposta nel messaggio di errore e correggere il problema del server remoto.

Codice errore: RestSinkUNSupportedCompressionType

  • Messaggio: User Configured CompressionType is Not Supported By Azure Data Factory：%message;

  • Raccomandazione: controllare i tipi di compressione supportati per il sink REST.

Risposta di rete imprevista dal connettore REST

  • Sintomi: l'endpoint a volte riceve una risposta imprevista (400, 401, 403, 500) dal connettore REST.

  • Causa: il connettore di origine REST usa l'URL e il metodo HTTP/intestazione/corpo dal servizio collegato/set di dati/copia origine come parametri quando costruisce una richiesta HTTP. Il problema è probabilmente causato da alcuni errori in uno o più parametri specificati.

  • Risoluzione:

    • Usare 'curl' in una finestra del prompt dei comandi per verificare se il parametro è la causa (le intestazioni Accept e User-Agent devono essere sempre incluse):

      curl -i -X <HTTP method> -H <HTTP header1> -H <HTTP header2> -H "Accept: application/json" -H "User-Agent: azure-data-factory/2.0" -d '<HTTP body>' <URL>

      Se il comando restituisce la stessa risposta imprevista, correggere i parametri precedenti con 'curl' fino a quando non restituisce la risposta prevista.

      È anche possibile usare "curl--help" per un utilizzo più avanzato del comando.

    • Se solo il connettore REST restituisce una risposta imprevista, contattare il supporto tecnico Microsoft per ulteriori operazioni di risoluzione dei problemi.

    • Si noti che "curl" potrebbe non essere adatto per riprodurre un problema di convalida del certificato SSL. In alcuni scenari, il comando "curl" è stato eseguito correttamente senza riscontrare problemi di convalida del certificato SSL. Tuttavia, quando lo stesso URL viene eseguito in un browser, non viene effettivamente restituito alcun certificato SSL per consentire al client di stabilire una relazione di trust con il server.

      Gli strumenti come Postman e Fiddler sono consigliati per il caso precedente.

Contenuto correlato

Per altre informazioni sulla risoluzione dei problemi, usare le risorse seguenti: