> ## Documentation Index
> Fetch the complete documentation index at: https://www.octoparse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Integración con Oracle

> Escribe en Oracle datos extraídos con Octoparse: configuración de Instant Client, propietario del esquema o tabla y modo upsert.

Escribe los datos extraídos directamente en una base de datos Oracle. Es necesario instalar Oracle Instant Client en el equipo que ejecuta Octoparse.

## Requisitos previos

* Plan Gratuito de Octoparse o superior
* Oracle 11g o posterior
* Oracle Instant Client (64 bits) instalado; consulta las instrucciones a continuación
* Una cuenta de usuario con permiso de escritura en el esquema de destino

***

## Instalar Oracle Instant Client

Octoparse utiliza el modo Thick para conectarse a Oracle, por lo que Instant Client es obligatorio.

1. Descarga **Instant Client Basic** (64 bits) desde el [sitio web de Oracle](https://www.oracle.com/database/technologies/instant-client/downloads.html).
2. Extráelo en un directorio local (por ejemplo, `C:\oracle\instantclient`).
3. Agrega ese directorio a la variable PATH del sistema.
4. Reinicia Octoparse.

> **Nota:** la arquitectura de Instant Client debe coincidir con la de Octoparse (ambas de 64 bits). Si las arquitecturas no coinciden, se produce el error `DPI-1047`.

***

## Configurar la exportación

Completa los ajustes de exportación en el siguiente orden:

**Nombre de configuración**

Asigna un nombre a la configuración para poder reutilizarla más adelante. El menú desplegable permite elegir una configuración existente o escribir un nombre nuevo para crear una.

**Datos de conexión**

| Campo                   | Descripción                                     | Ejemplo         |
| ----------------------- | ----------------------------------------------- | --------------- |
| Nombre del servidor     | Host de la base de datos (IP o dominio)         | `192.168.1.100` |
| Puerto                  | Número de puerto                                | `1521`          |
| Nombre de usuario       | Usuario de la base de datos                     | `scott`         |
| Contraseña              | Contraseña de la base de datos                  | —               |
| Propietario de la tabla | Esquema (propietario) al que pertenece la tabla | `SCOTT`         |

Octoparse genera automáticamente una cadena de conexión con el formato `{server}:{port}/{database}`.

> **El propietario de la tabla es obligatorio.** En Oracle, las tablas pertenecen a un esquema concreto; sin el propietario de la tabla, Octoparse no puede consultar ni escribir en el destino. Suele coincidir con el nombre de usuario, pero puede ser distinto cuando se utiliza un esquema compartido.

**Nombre de la base de datos**

En Oracle, Nombre de la base de datos es un campo de texto libre (nombre del servicio o SID); no hay ningún menú desplegable.

**Tabla de la base de datos**

Después de completar el nombre de la base de datos, elige la tabla de destino en el menú desplegable Tabla de la base de datos (consultado desde `user_tables`). Crea previamente la tabla en el esquema de destino; Octoparse lee sus columnas para asignar los campos.

**Probar conexión**

Haz clic en **Probar conexión** para validar la conexión y, a continuación, haz clic en **Exportar** para comenzar.

***

## Modos de escritura

### Anexar (Insert)

Cada exportación agrega filas nuevas al final de la tabla sin afectar a los datos existentes.

### Upsert (Insert o Update)

Decide qué hacer con cada fila mediante la clave primaria que especifiques: actualiza si el registro existe e inserta si no existe. Designa la columna de clave primaria en la asignación de campos; si la tabla de destino necesita una restricción de clave primaria, configúrala previamente en Oracle.

***

## Errores habituales

| Error       | Causa                                                | Solución                                              |
| ----------- | ---------------------------------------------------- | ----------------------------------------------------- |
| `DPI-1047`  | Falta Instant Client o su arquitectura es incorrecta | Instala Instant Client de 64 bits y agrégalo a PATH   |
| `ORA-12899` | El valor supera la longitud de la columna            | Amplía la columna (`ALTER TABLE ... MODIFY`)          |
| `ORA-01017` | Credenciales incorrectas                             | Vuelve a verificar las credenciales                   |
| `ORA-12541` | No se puede acceder al listener                      | Comprueba el host, el puerto y la conectividad de red |
| `ORA-00942` | La tabla o vista no existe                           | Confirma que el propietario de la tabla sea correcto  |