Conexión a Cloud SQL desde Microsoft Power BI usando ODBC y TLS/SSL

Estamos emocionados de seguir lanzando nuevas funciones para InterSystems IRIS Cloud SQL, como la nueva capacidad de Búsqueda Vectorial que se estrenó por primera vez con InterSystems IRIS 2024.1. Cloud SQL es un servicio en la nube que ofrece precisamente eso: acceso SQL en la nube. Esto significa que estaréis usando tecnologías de controladores estándar de la industria como JDBC, ODBC y DB-API para conectaros a este servicio y acceder a vuestros datos. La documentación describe en detalle cómo configurar los ajustes importantes a nivel de controlador, pero no cubre herramientas específicas de terceros, ya que, como podéis imaginar, hay un número infinito de ellas.

En este artículo, complementaremos esa documentación de referencia con pasos más detallados para una popular herramienta de visualización de datos de terceros que varios de nuestros clientes usan para acceder a datos basados en IRIS: Microsoft Power BI.

Paso 0: crear vuestra implementación

Primero, iniciad sesión en el Portal de Servicios en la Nube y cread una implementación de Cloud SQL. Lo único de lo que debéis estar atentos es de marcar la casilla para habilitar las conexiones externas. Aparte de eso, todos los ajustes predeterminados deberían funcionar bien.

Paso 1: Descargar el certificado

Para conectaros de manera segura, usaremos certificados para cifrar todo lo que se envíe a través de la red. Podéis descargar el certificado desde la página de detalles de la implementación a través del botón "Obtener certificado X.509":

Necesitamos referirnos a este certificado más adelante, por lo que debéis guardarlo en un directorio adecuado. Por ejemplo, estoy usando C:\Users\bdeboe\odbc\.

Paso 2: Crear el archivo SSLDefs.ini

Para saber qué certificado y configuraciones de cifrado usar, el controlador ODBC de InterSystems busca un archivoSSLDefs.ini, que crearemos a continuación. Por defecto, buscará este archivo en C:\Program Files (x86)\Common Files\InterSystems\IRIS, pero podéis cambiar esta ubicación usando la variable de entorno ISC_SSLconfigurations. Para mantener todas mis configuraciones juntas, establecí esa variable en C:\Users\bdeboe\odbc\ el directorio donde también guardé mi certificado.

El archivo SSLDefs.ini necesita contener dos cosas para que ODBC sepa cómo conectarse: una configuración de servidor y una configuración SSL. La configuración del servidor simplemente declara el nombre de la configuración SSL que se usará para una combinación particular de nombre de host y puerto, y la configuración SSL tiene todos los detalles para establecer la conexión cifrada. Esto hace que sea sencillo reutilizar una única configuración SSL para múltiples servidores. Aquí está el contenido de mi archivo SSLDefs.ini:

[My CloudSQL Server] 
Address=k8s-da0bcd5e-a1b3a0c7-545df92ec8-2e44304cebef1543.elb.us-east-1.amazonaws.com
Port=443
SSLConfig=SampleSSLConfig

[SampleSSLConfig]
CAFile=
CertFile=C:\Users\bdeboe\odbc\certificateSQLaaS.pem
KeyFile=
Password=
KeyType=2 
Protocols=28 
CipherList=ALL:!aNULL:!eNULL:!EXP:!SSLv2 
VerifyPeer=0 
VerifyDepth=9

La primera sección tiene la configuración del servidor, a la que podéis darle un nombre a vuestro gusto. Necesitaréis cambiar la Address para que coincida con el nombre de host de vuestra implementación de Cloud SQL, el cual podéis obtener de la página de detalles de la implementación donde descargasteis el certificado.

La segunda sección tiene la configuración SSL, cuyo nombre debe corresponder a lo que especificasteis para SSLConfig en la sección de configuración del servidor. La bandera CertFile obviamente debe coincidir con el lugar donde guardasteis vuestro certificado.

Para más detalles sobre las otras configuraciones, por favor, consultad la documentación completa sobre configuraciones TLS.

Paso 3: Crear el DSN de ODBC

Power BI, como la mayoría de las herramientas basadas en ODBC, funciona con DSNs (Nombre de Origen de Datos), que se registran usando una utilidad de Windows. Simplemente haced clic en el icono de Inicio de Windows y comenzad a escribir "ODBC", luego haced clic en "Orígenes de datos ODBC (64 bits)". Elegid la pestaña "DSN del sistema" para registrar una conexión con nuestra implementación de Cloud SQL. Si tenéis instalaciones locales de InterSystems IRIS (de las cuales tengo aproximadamente una docena en cualquier momento 😉), veréis que el instalador creó entradas DSN predeterminadas para ellas:

Haced clic en "Add..." o "Agregar..." para crear un nuevo DSN, eligiendo un nombre y llenando el host, puerto y namespace. Normalmente guardo mi nombre de usuario y contraseña en el DSN para las instancias que no son de producción (y los necesitaremos para probar la conexión en breve), pero podéis dejar estos campos en blanco y suministrar esas credenciales más tarde. El campo "Nombre del servidor SSL/TLS" es un poco redundante (¡trabajaremos en eso!).

 A continuación, haced clic en "Probar conexión" para verificar que todo funcione como se espera. Deberíais recibir un mensaje que dice "¡Prueba de conectividad completada con éxito!". Si no es así, verificad los pasos anteriores o consultad la guía de resolución de problemas. Un mensaje de error particular que puede confundiros (¡al menos a mí me confundió!) es "No SSL config found in the registry or in ssldefs.ini". Este error significa que el controlador ODBC no encontró una coincidencia para vuestra combinación de nombre de host/puerto en el archivo SSLDefs.ini. Como vuestro nombre de host cambia cada vez que creáis una nueva implementación, necesitaréis actualizar o añadir las configuraciones del servidor para cada una.

Paso 4: Conectar desde Power BI

Ahora es el momento de usar nuestro DSN de ODBC para cargar algunos datos en Power BI. Después de abrir la aplicación, seleccionad "Obtener datos" o "Obtener datos de otras fuentes", y elegid la opción ODBC:

Luego seleccionad el DSN que acabáis de crear de la lista:

En la siguiente pantalla, podéis proporcionar vuestro nombre de usuario y contraseña. No se requieren propiedades adicionales de credenciales.

 ¡Listo! Ahora podéis seleccionar las tablas que queréis incluir en vuestros informes de Power BI:

Como probablemente habéis notado, todos los pasos excepto el último en este artículo son universales para la configuración de ODBC, por lo que esto debería ayudaros con la mayoría de las herramientas basadas en ODBC. Espero que este artículo os haya sido útil, y no dudéis en añadir vuestros propios consejos y trucos, o compartir vuestras experiencias sobre cómo conectaros a Cloud SQL. También notad que prácticamente nada de lo que se menciona aquí, excepto el paso 0, es específico de Cloud SQL, por lo que podéis utilizar los mismos pasos para conectaros a cualquier instancia de IRIS que requiera conexiones cifradas.