Risoluzione dei problemi dei connettori

Imparate a risolvere i problemi comuni di Connector.

Panoramica

Quando si usano i connettori, si possono incontrare problemi che richiedono una certa conoscenza dei dettagli tecnici del loro funzionamento. Questa guida vi aiuterà a comprendere questi dettagli e a trovare soluzioni ai problemi più comuni dei connettori e a interpretare i codici di errore.

Problemi comuni dei connettori

Perché il mio connettore è offline?

Se il connettore risulta offline, significa che c'è un problema di connessione al server. Ciò potrebbe essere dovuto a due motivi: 1. Credenziali errate Controllare due volte i campi di immissione durante la configurazione del connettore e assicurarsi che le informazioni siano corrette. Se non si è sicuri, esaminare la documentazione del sistema di terze parti e le credenziali del proprio account per verificarle. I campi possono essere sensibili alle maiuscole e minuscole, quindi assicuratevi che i valori immessi siano identici a quelli indicati.2. Problemi con il sistema di terze parti I problemi di connessione possono dipendere dal sistema di terze parti stesso e da un problema con il suo server. Per ulteriori informazioni sui potenziali problemi di connessione, contattare l'amministratore del sistema.

Se non avete ancora configurato il vostro connettore o avete bisogno di una rinfrescata, consultate la nostra guida su Come configurare un connettore per una spiegazione passo per passo.

Cosa succede se la funzione del connettore non funziona?

Se una funzione del connettore non funziona, viene visualizzato un messaggio di errore e il sistema non tenta di riprovare la chiamata. I fallimenti possono essere dovuti a diversi motivi comuni:

1. Il sistema esterno non risponde alla richiesta API, per mancanza di risposta o per aver superato il tempo massimo di esecuzione del connettore.
2. L'host del connettore è offline.

Perché l'host del connettore è disconnesso?

È possibile vedere gli stati dell'host del connettore all'indirizzo: https://[your-instance].tulip.co/account-settings/connectors-settings

Se si utilizza un host connettore on-premise, verificare la presenza di problemi con il server o l'host.

Per coloro che utilizzano Tulip Cloud Connector Host, questo host connettore dovrebbe essere sempre online. Il Cloud Connector Host è un servizio gestito da Tulip. Contattare suppport@tulip.co se non è disponibile.

Dove posso trovare gli endpoint API per il mio sistema?

Cercando "API Docs [nome del sistema]" si ottiene quasi sempre una pagina dedicata agli sviluppatori con tutti gli endpoint API e i dettagli sulle specifiche come l'autenticazione e i parametri. Se ci sono esempi di ciascuno, gli esempi cURL sono di solito i più vicini a Tulip Connectors.

Se si utilizza l'API Tulip Table, la documentazione può essere consultata all'indirizzo: https://[your-instance].tulip.co/apiDocs

Che cos'è l'autorizzazione di base/portante?

L'autorizzazione di base e l'autorizzazione bearer sono intestazioni standard utilizzate per l'accesso.

L'intestazione "Authorization" avrà il valore "Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==" o "Bearer QWxhZGRpjpvcGVuIHNlc2FtZQ==". Sia i clienti TLS che quelli non TLS possono utilizzare l'autorizzazione di base. Il portatore dovrebbe essere solo per TLS.

Cosa sono X-auth-token, x-authentication, x-authentication-token?

Sono tutti esempi di intestazioni non regolamentate che vengono spesso utilizzate per l'autenticazione. La "X" indica che si tratta di intestazioni non standard.

Per maggiori dettagli su come impostarli, consultare la documentazione del sistema.

Perché la mia richiesta HTTP GET o POST non restituisce dati?

Se la richiesta GET o POST HTTP non restituisce alcun dato, controllare l'intestazione content-type. Questa intestazione è spesso necessaria, ma non sempre, per questi tipi di richiesta.

Perché non riesco a vedere l'output della mia query SQL?

Le colonne di output devono essere mappate per vedere qualsiasi risposta (mentre http mostrerà l'intera risposta senza alcun output mappato).

Perché i miei output non vengono utilizzati?

Osservare il formato degli output. Gli output sono sensibili alle maiuscole e spesso usano CamelCase o lowerCamelCase.

I connettori HTTP utilizzano anche la notazione a punti per gli oggetti annidati nei risultati. Per saperne di più sulla comprensione della notazione a punti, leggere questa guida esterna.

Codici di errore dei connettori

HTTP

I codici HTTP sono espansivi e i loro prefissi indicano il tipo di richiesta.

4xx - Richiesta errata2xx - Richiesta buona3xx - Richiesta mista

Per ulteriori informazioni, consultare questa guida sui codici di errore HTTP.

SQL

Con SQL, in genere i codici di errore provengono dalle richieste stesse.

Per ulteriori informazioni, consultare questa guida ai codici di errore SQL.

Ulteriori letture

• Panoramica dei connettori HTTP

Avete trovato quello che cercavate?

Potete anche andare su community.tulip.co per porre la vostra domanda o vedere se altri hanno affrontato una questione simile!