Conexión Destino Oracle

Requisitos previos

Antes de configurar la conexión de destino Oracle en Crestone, asegúrese de cumplir con los siguientes requisitos:

Requisito principal: Una instancia activa y accesible de Oracle Database, versión 12.1 (12c Release 1) o superior, con un usuario que posea privilegios de escritura en el esquema destino. Oracle 11g y versiones anteriores no están soportadas.

Información requerida:

Importante: En Oracle, un esquema y un usuario son el mismo concepto. El usuario configurado en Crestone cargará datos en su propio esquema de manera predeterminada. Para escribir en otro esquema, el usuario debe contar con privilegios explícitos de CREATE TABLE e INSERT en dicho esquema.

Consejo: Si se conecta a una instancia de prueba local de Oracle Free, utilice los siguientes valores:

• Server: localhost
• Port: 1521
• Service Name: FREEPDB1
• Username / Password: credenciales del usuario del esquema (ej. crestone / crestone123)

Paso de verificación previa

Antes de configurar la conexión en Crestone, recomendamos verificar sus credenciales utilizando cualquier cliente Oracle de su preferencia (ej. SQL Developer, DBeaver, SQLcl). Esto asegura que las credenciales sean correctas y que el servidor sea accesible antes de proceder.

Pasos de configuración

Siga estos pasos para crear una nueva conexión de destino Oracle 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 Base de Datos Oracle).

5. En el menú desplegable Destination Type, seleccione Oracle.

6. Complete el formulario de credenciales con los campos requeridos:

   • Server — host o dirección IP de su instancia de Oracle
   • Port — predeterminado 1521
   • Service Name — nombre de servicio de Oracle que identifica la base de datos
   • Username — usuario de base de datos
   • 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 Oracle existente:

1. Diríjase a Connections y localice su destino Oracle.
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 Oracle 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 Oracle.
3. En Select Schema, elija un esquema existente de la lista, o seleccione Create new table (use connected user schema) para cargar datos directamente en el esquema del usuario conectado.
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: Al seleccionar Create new table, Crestone infiere automáticamente los tipos de columna a partir de los datos de origen y crea la tabla en Oracle antes de insertar registros. El mapeo de tipos aplicado es:

Tipo de origen	Tipo Oracle
Int8 / Int16	NUMBER(5)
Int32	NUMBER(10)
Int64	NUMBER(19)
Float32	BINARY_FLOAT
Float64	BINARY_DOUBLE
Boolean	NUMBER(1)
String	VARCHAR2(4000)
Date	DATE
Datetime	TIMESTAMP

Importante: Los esquemas de Oracle no se pueden crear automáticamente; están vinculados a usuarios de la base de datos. Si necesita cargar datos en un esquema que aún no existe, solicite previamente a su DBA que cree el usuario de Oracle correspondiente.

Problemas comunes

Permisos requeridos

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

-- Permitir conexión (otorgado por defecto al crear el usuario)
GRANT CREATE SESSION TO crestone;

-- Permitir creación de tablas en el propio esquema del usuario
GRANT CREATE TABLE TO crestone;

-- Asignar cuota suficiente para escribir datos en el tablespace
ALTER USER crestone QUOTA UNLIMITED ON USERS;

-- Para escribir en el esquema de otro usuario, se requieren permisos adicionales (ejecutar como DBA):
GRANT CREATE ANY TABLE TO crestone;
GRANT INSERT ANY TABLE TO crestone;
GRANT DELETE ANY TABLE TO crestone;

Consejo: Si el usuario de Oracle configurado en Crestone es propietario del esquema donde se cargarán los datos (es decir, el nombre de usuario y el nombre de esquema son idénticos), únicamente se requieren CREATE SESSION, CREATE TABLE y cuota en el tablespace — no se necesitan permisos adicionales.