--- title: "How to Write a SQL Connector Function" slug: "how-to-write-a-sql-connector-function" updated: 2023-10-31T16:14:16Z published: 2023-10-31T16:14:16Z canonical: "support.tulip.co/how-to-write-a-sql-connector-function" --- > ## Documentation Index > Fetch the complete documentation index at: https://support.tulip.co/llms.txt > Use this file to discover all available pages before exploring further. # Come scrivere una funzione SQL Connector ## Come scrivere una funzione connettore SQL *Utilizzate questa guida per collegare la vostra applicazione Tulip a un database SQL.* Ecco un esempio di come utilizzare la funzione Connettori di Tulip per connettersi a un database SQL. ## Per aggiungere un nuovo connettore SQL: 1- Andate alla pagina Connettori posizionando il cursore su Applicazioni nella barra dei menu e scegliendo Connettori dal menu a tendina. ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/How%20to%20Write%20a%20SQL%20Connector%20Function_92652982.png) 2- Fare clic su "Aggiungi connettore" in alto a destra, assegnare un nome al connettore e selezionare "SQL" come tipo di connettore. ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/How%20to%20Write%20a%20SQL%20Connector%20Function_122142519.png) 3- Nella scheda Ambienti del nuovo connettore, selezionare "Aggiungi dettagli di connessione". ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/How%20to%20Write%20a%20SQL%20Connector%20Function_122142740.png) 4- Compilare i dettagli appropriati per connettersi al database: - Esecuzione su ("Cloud Connector Host", a meno che non sia stata impostata diversamente) - Tipo - Server - Porta - SSL (sì o no) - Database - Nome utente - Password ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/How%20to%20Write%20a%20SQL%20Connector%20Function_122143231.png) 5- Fare clic sul pulsante Test per eseguire un segnale di prova. Se il test ha esito positivo, premere "Salva". 6- Assicurarsi che l'host del connettore abbia accesso al database (indicato dall'etichetta verde "Online" accanto al server nella pagina Connettori). ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/How%20to%20Write%20a%20SQL%20Connector%20Function_122143661.png) Una volta configurato con successo un nuovo connettore, è ora possibile creare funzioni di connettore per inviare o recuperare dati dal database esterno. Una funzione connettore deve essere scritta nella lingua del database di destinazione. ## Per impostare una nuova funzione connettore SQL: 1- Fare clic sul pulsante "Aggiungi nuova funzione" nella scheda Funzioni. ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/How%20to%20Write%20a%20SQL%20Connector%20Function_122144683.png) 2- Assegnare un nome alla nuova funzione (in questo modo è possibile scegliere la funzione connettore specifica in Triggers). 1. Configurare gli ingressi e le uscite della funzione ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/How%20to%20Write%20a%20SQL%20Connector%20Function_156366200.png) Nell'esempio precedente: **Ingressi** - configurazione (testo) **Uscite** - sottoconfigurazione_1 - sottoconfigurazione_2 - subconfig_3 **Query** `SELECT subconfig_1, subconfig_2, subconfig_3 FROM database webinar WHERE configuration = $configuration$ order by id desc limit 1````` Una funzione può avere più ingressi e uscite. È necessario almeno un ingresso o un'uscita per inviare/ricevere dati da un'applicazione Tulip. - Fare clic su *Aggiungi* per aggiungere un nuovo ingresso o uscita - Assegnare al campo un nome riconoscibile - Scegliere il tipo di dati (ad es. testo, booleano, intero, ecc.). - Aggiungere un'istruzione SQL valida nel campo Query. Si noti che i nomi delle variabili di input devono essere racchiusi in $. Esempio: `$input$`. - Testare la funzione - Se la funzione ha degli input, inserire dei valori validi. - Fare clic su "Test" in alto a destra. - Visualizzare i risultati del test o i messaggi di errore nella sezione *Risultati del test*. ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/How%20to%20Write%20a%20SQL%20Connector%20Function_156366811.png) 1. In alcuni casi, si può desiderare di restituire più righe da una tabella SQL. A tale scopo, selezionare la casella accanto a "Restituisci più righe". In questo modo verrà restituita una matrice di oggetti, in cui ogni oggetto contiene i valori di una riga della tabella SQL. ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/How%20to%20Write%20a%20SQL%20Connector%20Function_156367028.png) **Query** `SELECT name, num from numbers where num > $number$` (nell'esempio precedente, il *numero* è un input) Quando si aggiungono gli input e si fa clic su "Test", dovrebbero essere restituite tutte le righe previste in "Risultati del test". ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/How%20to%20Write%20a%20SQL%20Connector%20Function_105139978.png) Questi possono essere memorizzati in una variabile come array di oggetti nell'Editor Trigger. 1. Al termine, premere "Salva". :::(Warning) (NOTA) Gli ingressi e le uscite **non possono** essere modificati dopo aver salvato una funzione. Questo per evitare interruzioni alle applicazioni che potrebbero utilizzare una funzione del connettore. ::: Se è necessario aggiungere nuovi ingressi/uscite, è possibile copiare la funzione e apportare le modifiche nella nuova funzione. Per ulteriori informazioni su come scrivere alcune funzioni SQL comunemente utilizzate, consultare["Funzioni comuni del connettore SQL](https://support.tulip.co/docs/common-sql-connector-functions)". ## Ulteriori letture - [Come utilizzare l'output delle funzioni del connettore nelle applicazioni](https://support.tulip.co/docs/how-to-use-outputs-from-connector-functions-in-apps) - [Panoramica dei connettori HTTP](https://support.tulip.co/docs/an-overview-of-http-connectors) --- Avete trovato quello che cercavate? Potete anche andare su [community.tulip.co](https://community.tulip.co/?utm_source=intercom&utm_medium=article-link&utm_campaign=all) per porre la vostra domanda o vedere se altri hanno affrontato una domanda simile!