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