Conexión Fuente Sybase

Requisitos Previos

Antes de configurar la conexión de origen SAP ASE en Crestone, asegúrese de contar con lo siguiente:

Requisito Principal: Una instancia activa y accesible de SAP ASE (Sybase), versión 12.5.1 o superior, con un usuario que posea privilegios de lectura en la base de datos de destino. Las siguientes versiones son totalmente compatibles:

Nota: Crestone se conecta a SAP ASE mediante pyodbc con el controlador de código abierto FreeTDS (versión de protocolo TDS 5.0). No se requiere ningún controlador ODBC con licencia de SAP en el servidor de Crestone.

Información Requerida:

Paso de Pre-Verificación

Antes de configurar la conexión en Crestone, recomendamos verificar sus credenciales utilizando un cliente SQL compatible como DBeaver, DataGrip o la CLI isql (parte de FreeTDS). Esto garantiza que el servidor sea accesible y que las credenciales sean correctas antes de continuar.

Consejo para DBeaver: Para conectarse a SAP ASE desde DBeaver, seleccione Sybase ASE como el tipo de controlador. Asegúrese de que la versión de TDS esté configurada en 5.0 en las propiedades avanzadas del controlador. DBeaver utiliza un controlador JDBC para Sybase (jTDS o el controlador JDBC de Sybase), mientras que Crestone utiliza FreeTDS/ODBC; ambos usan TDS 5.0 y deben comportarse de manera consistente para la validación de credenciales.

Pasos de Configuración

Siga estos pasos para crear una nueva conexión de origen SAP ASE en Crestone:

1. Navegue a Connections en la barra de navegación superior.
2. Seleccione la pestaña Source.
3. Haga clic en el botón + para crear una nueva conexión.
4. Complete el campo Connection Name con un nombre descriptivo (ej. Mi Fuente Sybase).
5. En el menú desplegable Source Type, seleccione SAP ASE (Sybase).
6. Complete el formulario de credenciales con los campos requeridos:
   • Server — host o dirección IP de su instancia ASE
   • Port — predeterminado 5000
   • Database — nombre de la base de datos ASE a la que conectarse
   • Username — usuario de la base de datos
   • Password — contraseña del usuario
7. Haga clic en Test Connection para validar que Crestone pueda comunicarse exitosamente con la base de datos.
8. Una vez superada la prueba, haga clic en Create Source para guardar la conexión.

Edición de una Conexión Existente

Para actualizar las credenciales de una conexión de origen SAP ASE existente:

1. Navegue a Connections y localice su origen SAP ASE.
2. Haga clic en Edit.
3. Modifique los campos deseados en el formulario de credenciales.
4. Haga clic en Test Connection para verificar las nuevas credenciales.
5. Haga clic en Confirm para guardar los cambios.

Uso de SAP ASE como Fuente en un Nodo de Extracción

Una vez creada la conexión, puede utilizarla como origen de un Extraction Node. Hay dos modos de extracción disponibles:

Modo Visual

Configure la extracción sin necesidad de escribir código SQL:

1. Abra o cree un Extraction Node y vaya a la pestaña Source.
2. En Select Source, elija su conexión SAP ASE.
3. En Select Schema, elija el esquema (usuario de la base de datos) que posee las tablas que desea extraer.
4. En Select Table, elija la tabla a extraer.
5. En Select Fields, seleccione las columnas específicas que necesita, o déjelo vacío para extraer todas las columnas.
6. Opcionalmente, agregue una condición WHERE para filtrar filas.
7. El panel de Preview muestra una muestra de los datos que se extraerán.

Modo SQL Script

Escriba una consulta SQL personalizada para extracciones más complejas:

1. Seleccione la fuente y el esquema como en el Modo Visual.
2. Cambie al modo SQL Script.
3. Escriba su consulta SQL utilizando la sintaxis estándar T-SQL de Sybase ASE.
4. Haga clic en Run Preview para validar y previsualizar los resultados de la consulta.

Nota: El modo SQL Script admite cualquier sentencia SELECT válida de ASE, incluyendo JOIN, subconsultas, funciones de agregación y GROUP BY. Evite sentencias DDL (CREATE, DROP, ALTER) en este campo.

Nota sobre esquemas: En SAP ASE, los esquemas corresponden a los usuarios de la base de datos. Un esquema denominado dbo es el esquema predeterminado propiedad del DBA. Los esquemas creados por usuarios (ej. crestone) corresponden a usuarios de bases de datos con el mismo nombre. Crestone lista todos los usuarios de la base de datos conectada que están disponibles como esquemas.

Manejo de Tipos de Datos

Cuando Crestone lee datos de SAP ASE, los tipos de columna se devuelven a través del cursor ODBC y se asignan internamente a tipos Polars. Dado que pyodbc/FreeTDS devuelve tipos nativos de Python, la asignación se determina en tiempo de ejecución según los valores:

Nota: Los tipos de Python no estándar (ej. Decimal, datetime) se convierten automáticamente a string para garantizar la compatibilidad entre todos los conectores de destino. Si necesita preservar la precisión numérica exacta, considere realizar un cast en su consulta de SQL Script.

Problemas Frecuentes

Permisos Requeridos

Para acceso de solo lectura (extracción de origen), el usuario de base de datos requiere como mínimo los siguientes privilegios:

-- Conceder SELECT en todas las tablas propiedad de un usuario/esquema específico
GRANT SELECT ON dbo.my_table TO crestone_user
GO

-- O conceder SELECT en todas las tablas de la base de datos (requiere rol DBA o resource)
GRANT SELECT ON ALL TO crestone_user
GO

Nota: En SAP ASE, el permiso SELECT se otorga por tabla o por usuario. No existe un equivalente a GRANT SELECT ON *.* TO user como en MySQL. Solicite a su DBA que otorgue SELECT sobre las tablas específicas que necesita extraer o asigne el usuario a un grupo con los permisos correspondientes.

Nota: Para listar esquemas (usuarios) y tablas en la interfaz de descubrimiento de esquemas, Crestone consulta las tablas del sistema sysusers y sysobjects. Estas tablas son legibles de manera predeterminada por cualquier usuario autenticado en ASE.