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

# SQL-Server-Integration

> Schreiben Sie mit Octoparse gescrapte Daten in Microsoft SQL Server – mit Windows- oder SQL-Server-Authentifizierung und TLS-verschlüsselten Verbindungen.

Schreiben Sie gescrapte Daten direkt in Microsoft SQL Server. Unterstützt werden die Windows-Authentifizierung und die Authentifizierung mit einem SQL-Server-Konto.

***

## Voraussetzungen

* Octoparse Free-Plan oder höher
* Eine SQL-Server-Instanz, die von Octoparse über das Netzwerk erreichbar ist
* Ein Benutzerkonto mit Schreibberechtigung für die Zieldatenbank
* Für die Windows-Authentifizierung: Der Octoparse-Desktop-Client muss unter Windows ausgeführt werden und SQL Server Native Client 11.0 muss installiert sein

***

## 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-Menü können Sie eine vorhandene Konfiguration auswählen oder einen neuen Namen eingeben, um eine zu erstellen.

**Verbindungsdetails**

| Feld | Beschreibung | Standardwert |
| - | - | - |
| Servername | Datenbankhost (IP oder Domain) | — |
| Port | Portnummer | `1433` |
| Authentifizierung | Authentifizierungsmethode (siehe unten) | — |
| Benutzername | SQL-Server-Konto | — |
| Passwort | Kontopasswort | — |
| Verbindung verschlüsseln | TLS aktivieren | Aus |

**Authentifizierungsoptionen:**

| Option | Beschreibung | Plattform |
| - | - | - |
| SQL-Server-Authentifizierung | Verbindung mit einem Datenbankkonto und Passwort herstellen | Windows/macOS |
| Windows-Authentifizierung | Verbindung als aktuell angemeldeter Windows-Benutzer herstellen – Benutzername und Passwort sind nicht erforderlich | Nur Windows |

Wenn die Windows-Authentifizierung ausgewählt ist, sind die Felder Benutzername und Passwort deaktiviert.

> **Verbindung verschlüsseln:** Azure SQL Database und viele verwaltete SQL-Server-Instanzen erfordern standardmäßig eine Verschlüsselung. Aktivieren Sie diese Option.

**Datenbankname**

Nachdem Sie die Verbindungsdetails ausgefüllt haben, klicken Sie auf das Dropdown-Menü Datenbankname. Octoparse stellt eine Verbindung her und listet die Datenbanken ohne Systemdatenbanken auf. Wählen Sie die Zieldatenbank aus.

**Datenbanktabelle**

Wählen Sie nach der Datenbank die Zieltabelle im Dropdown-Menü Datenbanktabelle aus. Erstellen Sie die Tabelle vorab; Octoparse liest ihre Spalten für die Feldzuordnung ein.

**Verbindung testen**

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

***

## Schreibmodi

### Anhängen (Einfügen)

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

### Upsert (Einfügen oder Aktualisieren)

Die angegebene Primärschlüsselspalte entscheidet für jede Zeile: Ist der Datensatz vorhanden, wird er aktualisiert; andernfalls wird er eingefügt. Legen Sie die Primärschlüsselspalte in der Feldzuordnung fest.

***

## Häufige Fehler

| Fehler | Ursache | Lösung |
| - | - | - |
| `Login failed for user` | Falsche Anmeldedaten | Anmeldedaten erneut prüfen |
| `Cannot open database` | Falscher Datenbankname oder unzureichende Berechtigungen | Datenbanknamen und Kontoberechtigungen bestätigen |
| `Connection refused` | Netzwerk nicht erreichbar oder falscher Port | Firewallregeln und den Listener-Port von SQL Server prüfen |
| `SSL connection required` | Server erfordert Verschlüsselung, aber Verbindung verschlüsseln ist deaktiviert | Verbindung verschlüsseln aktivieren |
| Windows-Authentifizierung nicht verfügbar | Host ist kein Windows-System oder Native Client ist nicht installiert | Zur SQL-Server-Authentifizierung wechseln oder SQL Server Native Client 11.0 installieren |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.