Conexión Destino SAP ASE Sybase

Requisitos previos

Antes de configurar la conexión de destino 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 escritura en la base de datos de destino. Las siguientes versiones están totalmente soportadas:

Nota: Crestone se conecta a SAP ASE utilizando 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:

Importante: En SAP ASE, los esquemas corresponden a usuarios de la base de datos. Crestone carga datos en tablas pertenecientes al usuario configurado (ej. crestone_user.my_table). A diferencia de MySQL o PostgreSQL, ASE no crea esquemas automáticamente; el esquema (usuario) debe existir previamente en la base de datos antes de utilizarse como destino. Contacte a su DBA para crear el usuario si es necesario.

Paso de verificación previa

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

Pasos de configuración

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

1. Diríjase a Connections en la barra de navegación superior.
2. Seleccione la pestaña Destination.
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 Destino Sybase).
5. En el menú desplegable Destination 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 donde se cargarán los datos
   • Username — usuario de base de datos con privilegios de escritura
   • Password — contraseña del usuario
7. Haga clic en Test Connection para validar que Crestone pueda comunicarse con la base de datos exitosamente.
8. Una vez aprobada la prueba, haga clic en Create Destination para guardar la conexión.

Edición de una conexión existente

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

1. Diríjase a Connections y localice su destino 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 destino en un nodo de extracción

Una vez creada la conexión, puede utilizarla como destino en un nodo de extracción (Extraction Node):

1. Abra o cree un Extraction Node y diríjase a la pestaña Destination.
2. En Select Destinations, elija su conexión SAP ASE.
3. En Select Schema, elija un esquema existente (usuario de base de datos) de la lista.
4. En Select Table, elija una tabla existente o seleccione Create new table para que Crestone la cree automáticamente según la estructura de datos de origen.
5. Opcionalmente, habilite Prefers to delete existing data and then insert new data si desea truncar la tabla antes de cada carga.
6. Continúe a la pestaña Settings y guarde el nodo.

Nota sobre esquemas: La lista de esquemas muestra todos los usuarios de base de datos definidos en la base de datos ASE conectada. Crestone escribirá datos en tablas pertenecientes al usuario de esquema seleccionado. Si el esquema que requiere no aparece en la lista, solicite a su DBA que cree el usuario de base de datos correspondiente y le asigne los permisos apropiados.

Nota: Al seleccionar Create new table, Crestone infiere automáticamente los tipos de columna a partir de los datos de origen y ejecuta una sentencia CREATE TABLE antes de insertar registros. Los nombres de columnas del origen se sanean para convertirse en identificadores válidos de ASE (alfanuméricos y guion bajo únicamente, en mayúsculas). El mapeo de tipos aplicado es:

Tipo de origen Polars	Tipo ASE creado
Int8, Int16	SMALLINT
Int32	INT
Int64	BIGINT
Float32	REAL
Float64	FLOAT
Boolean	TINYINT
Date	DATETIME
Datetime	DATETIME
String y otros	VARCHAR(255)

Saneamiento de nombres de columnas

SAP ASE impone reglas estrictas para identificadores. Crestone sanea automáticamente los nombres de columna del origen antes de crear tablas o insertar datos en ASE:

• Todos los caracteres no alfanuméricos (espacios, /, -, ., etc.) se reemplazan por _
• Los guiones bajos o dígitos iniciales se eliminan o se prefijan con C_
• Todos los nombres se convierten a mayúsculas
• Los nombres duplicados tras el saneamiento se desambiguan con un sufijo numérico (ej. NAME_1, NAME_2)

Por ejemplo:

Nota: Los nombres de columna saneados son los que aparecerán en la tabla de ASE. Si realiza uniones (joins) de esta tabla con otros sistemas, asegúrese de referenciar los nombres saneados.

Problemas comunes

Permisos requeridos

El usuario de base de datos configurado en Crestone requiere como mínimo los siguientes privilegios para cargar datos como destino:

-- Permitir al usuario crear tablas en su propio esquema (predeterminado en ASE para el propietario del esquema)
-- El usuario es propietario automático de los objetos que crea, por lo que no se requiere un permiso adicional
-- para CREATE TABLE dentro de su propio esquema.

-- Otorgar INSERT, SELECT, DELETE en la base de datos destino al usuario:
GRANT INSERT, SELECT, DELETE ON my_table TO crestone_user
GO

-- Si el usuario requiere crear tablas en el esquema de otro usuario:
GRANT CREATE TABLE TO crestone_user
GO

Nota: En SAP ASE, un usuario de base de datos tiene automáticamente el derecho de crear tablas dentro de su propio esquema (es decir, tablas de las cuales es propietario). No se requiere ninguna concesión adicional siempre que el esquema de destino coincida con el nombre de usuario configurado en Crestone. Por ejemplo, si el nombre de usuario es crestone_user, Crestone escribirá en crestone_user.my_table de forma predeterminada.

Importante: Crestone no crea esquemas (usuarios de base de datos) automáticamente. El esquema seleccionado en el nodo de extracción debe existir previamente como usuario de base de datos en ASE. Solicite a su DBA ejecutar:

sqlCopiar

-- Crear un nuevo usuario de base de datos (esquema) en ASE
USE my_database
GO
sp_adduser 'crestone_user', 'crestone_user', 'null'
GO

El usuario también debe existir como login en el servidor ASE:

sqlCopiar

-- Crear primero el login a nivel de servidor
sp_addlogin 'crestone_user', 'strong_password'
GO

-- Luego agregarlo a la base de datos destino
USE my_database
GO
sp_adduser 'crestone_user'
GO