> ## 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.

# Oracle-Integration

> Schreiben Sie mit Octoparse extrahierte Daten in Oracle – mit Einrichtung von Instant Client, Schema bzw. Tabelleneigentümer und Upsert-Modus.

Schreiben Sie extrahierte Daten direkt in eine Oracle-Datenbank. Dazu muss Oracle Instant Client auf dem Computer installiert sein, auf dem Octoparse ausgeführt wird.

## Voraussetzungen

* Kostenloser Octoparse-Plan oder höher
* Oracle 11g oder neuer
* Oracle Instant Client (64 Bit) installiert – siehe unten
* Ein Benutzerkonto mit Schreibberechtigung für das Zielschema

***

## Oracle Instant Client installieren

Octoparse stellt die Verbindung zu Oracle im Thick-Modus her. Daher ist Instant Client erforderlich.

1. Laden Sie **Instant Client Basic** (64 Bit) von der [Oracle-Website](https://www.oracle.com/database/technologies/instant-client/downloads.html) herunter.
2. Extrahieren Sie die Dateien in ein lokales Verzeichnis (z. B. `C:\oracle\instantclient`).
3. Fügen Sie dieses Verzeichnis dem Systempfad PATH hinzu.
4. Starten Sie Octoparse neu.

> **Hinweis:** Die Architektur von Instant Client muss der von Octoparse entsprechen (beide 64 Bit). Nicht übereinstimmende Architekturen lösen `DPI-1047` aus.

***

## Export konfigurieren

Füllen Sie die Exporteinstellungen in der folgenden Reihenfolge aus:

**Konfigurationsname**

Geben Sie der Konfiguration einen Namen, damit Sie sie später wiederverwenden können. Im Dropdown können Sie eine vorhandene Konfiguration auswählen oder einen neuen Namen eingeben, um eine zu erstellen.

**Verbindungsdetails**

| Feld               | Beschreibung                                   | Beispiel        |
| ------------------ | ---------------------------------------------- | --------------- |
| Servername         | Datenbankhost (IP oder Domain)                 | `192.168.1.100` |
| Port               | Portnummer                                     | `1521`          |
| Benutzername       | Datenbankbenutzer                              | `scott`         |
| Passwort           | Datenbankpasswort                              | —               |
| Tabelleneigentümer | Schema (Eigentümer), zu dem die Tabelle gehört | `SCOTT`         |

Octoparse erstellt automatisch eine Verbindungszeichenfolge im Format `{server}:{port}/{database}`.

> **Der Tabelleneigentümer ist erforderlich.** In Oracle gehören Tabellen zu einem bestimmten Schema. Ohne Tabelleneigentümer kann Octoparse die Zieltabelle weder abfragen noch beschreiben. Normalerweise entspricht er dem Benutzernamen, kann bei einem gemeinsam genutzten Schema aber davon abweichen.

**Datenbankname**

Bei Oracle ist der Datenbankname ein Freitextfeld (Servicename oder SID); es gibt kein Dropdown.

**Datenbanktabelle**

Wählen Sie nach Eingabe des Datenbanknamens die Zieltabelle im Dropdown „Datenbanktabelle“ aus (Abfrage aus `user_tables`). Erstellen Sie die Tabelle vorab im Zielschema. Octoparse liest ihre Spalten für die Feldzuordnung aus.

**Verbindung testen**

Klicken Sie auf **Verbindung testen**, um die Verbindung zu prüfen, und anschließend auf **Exportieren**, um den Vorgang zu starten.

***

## Schreibmodi

### Anhängen (Einfügen)

Bei jedem Export werden neue Zeilen am Ende der Tabelle angefügt, ohne bestehende Daten zu verändern.

### Upsert (Einfügen oder Aktualisieren)

Anhand des von Ihnen angegebenen Primärschlüssels wird für jede Zeile entschieden: Ist der Datensatz vorhanden, wird er aktualisiert, andernfalls wird er eingefügt. Legen Sie die Primärschlüsselspalte in der Feldzuordnung fest. Wenn die Zieltabelle eine Primärschlüsseleinschränkung benötigt, konfigurieren Sie diese vorab in Oracle.

***

## Häufige Fehler

| Fehler      | Ursache                                               | Lösung                                                                  |
| ----------- | ----------------------------------------------------- | ----------------------------------------------------------------------- |
| `DPI-1047`  | Instant Client fehlt oder hat die falsche Architektur | Installieren Sie den 64-Bit-Instant-Client und fügen Sie ihn PATH hinzu |
| `ORA-12899` | Wert überschreitet die Spaltenlänge                   | Vergrößern Sie die Spalte (`ALTER TABLE ... MODIFY`)                    |
| `ORA-01017` | Falsche Anmeldedaten                                  | Prüfen Sie die Anmeldedaten erneut                                      |
| `ORA-12541` | Listener ist nicht erreichbar                         | Prüfen Sie Host, Port und Netzwerkverbindung                            |
| `ORA-00942` | Tabelle oder Ansicht ist nicht vorhanden              | Prüfen Sie, ob der Tabelleneigentümer korrekt ist                       |