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 all-in-one per le aziende. Microsoft Fabric copre tutto, dallo spostamento dati al data science, all'analisi in tempo reale, alla business intelligence e alla creazione di report. Vedere le informazioni su come iniziare una nuova prova gratuita!

Questo articolo fornisce suggerimenti per risolvere i problemi comuni relativi al 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.

      Strumenti come Fiddler sono consigliati per il caso precedente.

Il certificato dell'entità servizio in Azure Key Vault non è corretto

  • Messaggio: "Failed to create certificate from certificate raw data and password. Cannot find the requested object."
  • Causa: supporta solo il certificato dell'entità servizio stringa base64 per l'autenticazione del certificato dell'entità servizio del connettore Rest.
  • Raccomandazione: seguire questa sezione per salvare correttamente il certificato dell'entità servizio in Azure Key Vault.

Contenuto correlato

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