Creando una conexión ODBC - Paso a paso

Introducción

Este artículo tiene la intención de ser un sencillo tutorial de cómo crear conexiones ODBC y trabajar con ellas, ya que me pareció que empezar con ellas es un poco confuso. Yo tuve la ayuda de unas personas increíbles, y creo que todos merecemos ese apoyo.

Voy dividir cada pequeña parte en sesiones, así que puedes ir directamente a la que necesites, aunque recomiendo leerlo todo.

Voy a usar los datos de ejemplo creados en un artículo previo, Tutorial rápido para crear bases de datos de ejemplo: Samples.PersistentData, con las propiedades Name y Age.
 

Creando la conexión

1. Abre el ODBC Data Sources - busca ODBC en la barra de búsqueda de tu ordenador y lo encontrarás.
2. Selecciona la pestaña System DNS
3. Haz clic en Add
4. Selecciona el driver adecuado - para este ejemplo, estoy usando InterSystems IRIS ODBC35
5. Elige un nombre para la conexión
6. Escribe el servidor, puerto y namespace que quieres conectar (por ejemplo: IP 12.0.0.1, puerto 1972 y namespace SAMPLE)
7. Escribe el usuario y contraseña que vas a usar para conectar

Haz clic en "try connection" para comprobar si todo funciona bien - si no, verifica otra vez el usuario y contraseña, servidor, puerto y namespace, y también verifica si tu IRIS está iniciado (para este ejemplo), o si necesitas una VPN para esta conexión.

Nota: No sé si esto funciona de forma similar en Linux o iOS, ¡lo siento!
 

Usando tu conexión en una Business Operation en producción

Esto es solo un ejemplo de cómo puedes poner en práctica esta conexión, pero es muy utilizado.

Con una Business Operation con adaptador "EnsLib.SQL.OutboundAdapter" en producción, abre la pestaña de configuración y expande la parte de Parámetros Básicos. Vas a ver un DSN input como este:

Expande el input y encuentra la conexión que acabamos de crear. Si no esta ahí, verifica si la creaste en el ODBC Data Source correcto (32-bit o 64-bit).

Si no esta ahí, sigue los pasos otra vez de la otra opción y verifica el input DSN otra vez.

Credenciales

IRIS puede necesitar un usuario y contraseña para acceder a esta conexión, por lo que tienes que proporcionarlo.

Justo debajo del input DSN, vas a encontrar un input Credenciales con una lupa a su lado.

Haz clic en la lupa y verás el menú de credenciales.

En la pestaña a la derecha, haz clic en "Nuevo", escribe un ID que te ayudará a identificar la credencial, el usuario y contraseña necesarios y guárdalo.

¡Genial! Ahora que tienes tus credenciales, puedes volver a la producción y seleccionarlas por el ID que has elegido.

P.D.: un ejemplo para que pruebes

Para ese sencillo tutorial, he creado la siguiente clase en un namespace diferente de aquel en el que está "Sample.PersistentData":

Class Sample.ODBC.Operation Extends Ens.BusinessOperation
{

Parameter ADAPTER = "EnsLib.SQL.OutboundAdapter";
Property Adapter As EnsLib.SQL.OutboundAdapter;
Parameter INVOCATION = "Queue";
Method LegalAge(Request As Sample.request, Response As Sample.response) As %Status
{
    // instanciate the response
	Do Request.NewResponse(.Response)
	
	// Execute the query and select the first result
	Do ..Adapter.ExecuteQuery(.result, "SELECT Name, Age from Sample.PersistentData where Age > 20")
	Do result.%Next()
	
	// just for visualizing, sets the first result in the response
	Set Response.result = result.%Get("Name")_" "_result.%Get("Age")
	
	Quit 1
}

XData MessageMap
{
<MapItems>
	<MapItem MessageType="Sample.request"> 
		<Method>LegalAge</Method>
	</MapItem>	
</MapItems>
}

}

Gracias por leerme y espero que os resulte útil.

No dudéis en escribirme si tenéis alguna duda o comentario.