Conectar por ODBC

Cualquier aplicación que lea datos por ODBC puede leer las tablas de tu proyecto directamente, sin descargar archivos: planillas de cálculo, herramientas de BI, clientes SQL o scripts. Configurás la conexión una vez por computadora y desde ahí cada actualización en la aplicación trae los datos al día. Un administrador del proyecto le da acceso a cada persona en Salida de Datos; después la persona instala un driver y guarda la conexión en su computadora.

Antes de empezar

• Una computadora con Windows. Amazon también publica el driver para macOS y Linux, y su propia documentación explica cómo guardar la conexión ahí; los pasos de abajo son para Windows.
• Una aplicación que se conecte por ODBC, en su versión de 64 bits. El driver solo existe en 64 bits, y una aplicación de 32 bits no lo ve. La ventana “Acerca de” de la aplicación suele decir cuál tenés: en Excel, Archivo → Cuenta → “Acerca de Excel”, donde la primera línea termina en 64 bits o 32 bits.
• Permiso para instalar programas en la computadora, o alguien de sistemas que pueda hacerlo.
• Tu usuario de Teramot: es con el que iniciás sesión. No hay una contraseña aparte.
• Conexión a internet. En una red muy restringida, el área de sistemas tiene que permitir la salida a Teramot y a Amazon Web Services.

La conexión es para aplicaciones que una persona usa en su propia computadora: iniciar sesión abre un navegador ahí. Un reporte publicado en un servicio en línea o en un servidor compartido no puede actualizarse por esta conexión de forma programada; abrilo en la aplicación de tu computadora y actualizalo ahí.

En Teramot: darle acceso a la persona

Lo hace alguien con rol Administrador en el proyecto, desde Operación → Salida de Datos con el proyecto abierto.

1. En Gestión de Usuarios, hacé clic en Configurar en la fila de la persona. La lista muestra a todos los del proyecto, también a quienes fueron agregados solo a este proyecto. Si falta alguien, sumalo al proyecto, no al espacio de trabajo: un miembro del espacio de trabajo puede abrir todos sus proyectos.
2. Hacé clic en Activar acceso. Usa su usuario de Teramot, así que no recibe una contraseña nueva.
3. Activá cada tabla que puede leer. El acceso es tabla por tabla: si después le falta una, activala acá y aparece la próxima vez que actualice.
4. Hacé clic en Copiar datos de conexión y mandale el mensaje. Dice qué instalar y lista cada valor con el nombre del campo donde va. Ninguno de los valores es una contraseña. La pestaña Datos de conexión muestra los mismos valores uno por uno, y Copiar todos los campos los copia todos.

Instalar el driver

Tu aplicación se comunica con Teramot a través del driver Amazon Athena ODBC, gratuito y publicado por Amazon. Se instala una vez por computadora.

1. Abrí la página de Amazon Athena ODBC 2.x.
2. En “ODBC 2.x driver download”, en la fila Windows 64 bit, hacé clic en “Download link”. Se descarga un archivo que termina en .msi.
3. Abrilo, tildá “I accept the terms in the License Agreement” y seguí con “Next” e “Install” sin cambiar nada. Si Windows pregunta si permitís cambios, poné que sí. Cerrá con “Finish”. No hace falta una cuenta de Amazon.

Crear la conexión en Windows

La conexión, que Windows llama DSN, guarda los valores de tu proyecto para que cualquier aplicación de la computadora los use cada vez que actualiza.

1. En el menú Inicio de Windows escribí ODBC. Hacé clic derecho en “Orígenes de datos ODBC (64 bits)” y elegí “Ejecutar como administrador”. Tiene que ser la de 64 bits.
2. Andá a la pestaña “DSN de sistema”, así la conexión sirve para cualquier usuario de la computadora.
3. Hacé clic en “Agregar…”, elegí “Amazon Athena ODBC (x64)” y hacé clic en “Finalizar”. Puede que el instalador haya dejado un ejemplo vacío llamado Amazon Athena: podés completar ese.
4. En la ventana que se abre, completá cada campo con el valor del mismo nombre que viene en el mensaje. Copiá y pegá en lugar de tipear: una letra cambiada y la conexión no funciona. “Data Source Name” lo elegís vos, por ejemplo Teramot: es el nombre que vas a elegir en tu aplicación. Reemplazá los valores de ejemplo que trae la ventana.
5. Hacé clic en “Authentication Options”. En “Authentication Type” elegí BrowserOidcTip, entre JWT_TIP y Ping, no BrowserSSOOIDC, que se parece. Después completá los campos que aparecen, de la misma forma. Dejá Client Secret vacío y tildá “Enable JWT TIP File Cache”, así no te pide iniciar sesión a cada rato.
6. Cerrá esa ventana y hacé clic en “Test”. Se abre el navegador: iniciá sesión con tu usuario de Teramot. Cuando vuelve el mensaje de conexión exitosa, hacé clic en “OK” para guardar. Si cerrás con “Cancel”, no se guarda nada.

Usar la conexión desde tu aplicación

Si tu aplicación estaba abierta mientras creabas la conexión, cerrala y abrila de nuevo antes de empezar.

1. En tu aplicación, agregá un origen de datos de tipo ODBC. Cada aplicación lo nombra a su manera, por ejemplo “ODBC”, “Desde ODBC” u “Otras bases de datos (ODBC)”.
2. Elegí la conexión por el nombre que le pusiste. Si la aplicación pide una cadena de conexión, escribí DSN= seguido de ese nombre, por ejemplo DSN=Teramot.
3. Si pide usuario y contraseña, o cómo iniciar sesión, dejá los dos vacíos y elegí la opción que usa la configuración de la conexión: el inicio de sesión pasa en el navegador.
4. Las tablas están en el catálogo AwsDataCatalog, dentro de la base de tu proyecto: el valor de Database del mensaje. Solo están las tablas a las que te dieron acceso.

Ejemplo: Excel

Con Excel de escritorio de 64 bits (Microsoft 365, o Excel 2016 en adelante):

1. Buscá la opción ODBC, que depende de tu versión de Excel:
   • Microsoft 365, Excel 2019 o 2021: Datos → Obtener datos → Desde otras fuentes → Desde ODBC.
   • Excel 2016: Datos → Nueva consulta → Desde otras fuentes → Desde ODBC. El menú “Obtener datos externos” de esa versión no sirve para esto.
2. En “Nombre de origen de datos (DSN)” elegí el nombre que le pusiste a la conexión y hacé clic en “Aceptar”. Si pide usuario y contraseña, elegí “Predeterminado o personalizado” y hacé clic en “Conectar” sin completar nada.
3. En el “Navegador”, abrí AwsDataCatalog y después la base de tu proyecto, tildá la tabla que necesitás y hacé clic en “Cargar”.
4. La tabla aparece en una hoja nueva. Si algún título con tilde o eñe se ve raro, hacé clic derecho en la consulta → “Editar”, cambiale el nombre a la columna y elegí “Cerrar y cargar”. Guardá el libro: la conexión queda guardada adentro.

Si tu conexión no aparece en la lista, elegí “(Ninguno)”, abrí “Opciones avanzadas” y escribí DSN= seguido del nombre de tu conexión, por ejemplo DSN=Teramot.

Actualizar

Cada actualización en tu aplicación lee las tablas como están en ese momento; en Excel, Datos → Actualizar todo. Si se abre el navegador y te pide iniciar sesión, es normal: la sesión se renueva cada tanto. Para conservar los datos como están hoy, guardá o exportá una copia desde tu aplicación: la conexión siempre lee los datos actuales.

Ejemplo: una copia fija en Excel

1. Actualizá el libro original y revisá que los datos sean los que querés guardar.
2. Archivo → Guardar como, y guardá una copia en otra carpeta. A partir de ahí, lo que tenés abierto es la copia.
3. Hacé clic en cualquier celda de la tabla, después Herramientas de tabla → Diseño → “Convertir en rango”, aceptá el aviso y guardá.

Ahora la copia es fija: Actualizar todo ya no la cambia, y el original sigue conectado. Respetá ese orden: si convertís antes de guardar la copia, le cortás la conexión al original.

Si algo falla