Cómo escribir una función de conector SQL
  • 31 Oct 2023
  • 3 Minutos para leer
  • Colaboradores

Cómo escribir una función de conector SQL


Article Summary

Cómo escribir una función de conexión SQL

Utiliza esta guía para conectar tu aplicación Tulip a una base de datos SQL.

He aquí un ejemplo de cómo utilizar la función de conectores de Tulip para conectarse a una base de datos SQL.

Para añadir un nuevo conector SQL:

1- Ve a la página de Conectores situando el cursor sobre Apps en la Barra de Menús y seleccionando Conectores en el desplegable.

2- Pulsa "Añadir conector" en la parte superior derecha de la pantalla, dale un nombre a tu conector y selecciona "SQL" como tipo de conector.

3- En la pestaña Entornos del nuevo conector, selecciona "Añadir detalles de conexión".

4- Rellena los detalles apropiados para conectarte a la base de datos:

  • Running On ("Cloud Connector Host" a menos que hayas configurado una opción diferente)
  • Tipo
  • Servidor
  • Puerto
  • SSL (sí o no)
  • Base de datos
  • Nombre de usuario
  • Contraseña

5- Pulse el botón Prueba para ejecutar una señal de prueba. Si tiene éxito, pulse "Guardar".

6- Asegúrate de que el Host del Conector tiene acceso a la base de datos (indicado por la etiqueta verde "Online" junto al servidor en la página de Conectores).

Una vez que hayas configurado con éxito un nuevo conector, ahora puedes crear Funciones de Conector para enviar o recuperar datos de la base de datos externa. Una función de conector debe estar escrita en el idioma correspondiente de la base de datos de destino.

Para configurar una nueva función de conector SQL

1- Haz clic en el botón "Añadir nueva función" de la pestaña Funciones.

2- Dale un nombre a la nueva función (esto te permitirá elegir la función de conector específica en Triggers).

  1. Configura las Entradas y Salidas de la función

En el ejemplo anterior

Entradas

  • configuración (texto)

Salidas

  • subconfig_1
  • subconfig_2
  • subconfig_3

Consulta

`SELECT subconfig_1, subconfig_2, subconfig_3 FROM base de datos webinar WHERE configuración = $configuración$ order by id desc limit 1````

Una función puede tener varias entradas y salidas. Necesitarás al menos una entrada o salida para enviar/recibir datos de una Tulip App.

  • Haga clic en Añadir para añadir una nueva entrada o salida
  • Dé al campo un nombre reconocible
  • Elija el tipo de datos (por ejemplo, Texto, Booleano, Entero, etc.)
  • Añada una sentencia SQL válida en el campo Consulta. Tenga en cuenta que los nombres de las variables de entrada deben ir acompañados de $. Ejemplo
    $input$.
  • Pruebe la función
  • Si la función tiene entradas, introduzca valores válidos
  • Haga clic en "Probar" en la parte superior derecha.
  • Vea los resultados de la prueba o los mensajes de error en la sección Resultados de la prueba

  1. En algunos casos, es posible que desee devolver varias filas de una tabla SQL. Para ello, marque la casilla "Devolver varias filas". Esto devolverá un Array lleno de Objetos, donde cada objeto contiene valores de una fila de la tabla SQL.

Consulta

SELECT nombre, num de números donde num > $número$

(en el ejemplo anterior, número es una entrada)

A continuación, cuando añada sus entradas y haga clic en "Probar", debería ver todas las filas esperadas devueltas en "Resultados de la prueba".

Estos pueden ser almacenados en una Variable como un array lleno de Objetos en el Editor de Trigger.

7- Pulse "Guardar" cuando haya terminado.

:::(Warning) (NOTA) Las Entradas y Salidas no se pueden cambiar después de guardar una función. Esto es para evitar interrupciones a las aplicaciones que pueden estar utilizando una función de conector.
:::

Si necesitas añadir nuevas entradas/salidas, puedes copiar la función y hacer los cambios en la nueva función.

Para obtener más información sobre cómo escribir algunas funciones SQL de uso común, consulte "Funciones de conectorSQL comunes".

Lecturas Adicionales


¿Ha encontrado lo que buscaba?

También puedes dirigirte a community.tulip.co para publicar tu pregunta o ver si otras personas se han enfrentado a una pregunta similar.


¿Te ha sido útil este artículo?