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

# Integrazione SQL Server

> Scrivi i dati estratti da Octoparse in Microsoft SQL Server con autenticazione Windows o SQL Server e connessioni TLS.

Scrivi i dati estratti direttamente in Microsoft SQL Server. Sono supportate l'autenticazione Windows e quella tramite account SQL Server.

***

## Prerequisiti

* Piano gratuito Octoparse o superiore
* Istanza SQL Server raggiungibile da Octoparse tramite la rete
* Account utente con autorizzazione di scrittura sul database
* Per l'autenticazione Windows, client desktop Octoparse eseguito su Windows con SQL Server Native Client 11.0 installato

***

## Configurare l'esportazione

Compila le impostazioni nell'ordine seguente:

**Nome configurazione**

Assegna un nome alla configurazione per poterla riutilizzare. Dal menu puoi sceglierne una esistente o digitare un nuovo nome.

**Dettagli di connessione**

| Campo                   | Descrizione                          | Predefinito |
| ----------------------- | ------------------------------------ | ----------- |
| Nome server             | Host database, IP o dominio          | —           |
| Porta                   | Numero porta                         | `1433`      |
| Autenticazione          | Metodo di autenticazione, vedi sotto | —           |
| Nome utente             | Account SQL Server                   | —           |
| Password                | Password account                     | —           |
| Crittografa connessione | Attiva TLS                           | Disattivato |

**Opzioni di autenticazione:**

| Opzione                   | Descrizione                                                                        | Piattaforma     |
| ------------------------- | ---------------------------------------------------------------------------------- | --------------- |
| Autenticazione SQL Server | Connessione con account e password del database                                    | Windows / macOS |
| Autenticazione Windows    | Connessione come utente Windows attualmente connesso, senza nome utente o password | Solo Windows    |

Se selezioni Autenticazione Windows, i campi Nome utente e Password vengono disattivati.

> **Crittografa connessione:** Azure SQL Database e molte istanze SQL Server gestite richiedono la crittografia per impostazione predefinita; attiva questa opzione.

**Nome database**

Dopo aver compilato i dettagli, fai clic sul menu Nome database. Octoparse si connette ed elenca i database, esclusi quelli di sistema; scegli la destinazione.

**Tabella database**

Dopo aver scelto il database, seleziona la tabella dal relativo menu. Creala in anticipo; Octoparse ne legge le colonne per associare i campi.

**Test connessione**

Fai clic su **Test connessione** per convalidarla, quindi su **Esporta** per iniziare.

***

## Modalità di scrittura

### Aggiunta (Insert)

Ogni esportazione aggiunge nuove righe in fondo alla tabella senza modificare i dati esistenti.

### Upsert (Insert o Update)

Decide riga per riga in base alla chiave primaria specificata: aggiorna il record se esiste, altrimenti lo inserisce. Indica la colonna della chiave primaria nell'associazione dei campi.

***

## Errori comuni

| Errore                                 | Causa                                               | Soluzione                                                         |
| -------------------------------------- | --------------------------------------------------- | ----------------------------------------------------------------- |
| `Login failed for user`                | Credenziali errate                                  | Verifica nuovamente le credenziali                                |
| `Cannot open database`                 | Nome database errato o autorizzazioni insufficienti | Verifica nome e autorizzazioni dell'account                       |
| `Connection refused`                   | Rete irraggiungibile o porta errata                 | Controlla firewall e porta di ascolto SQL Server                  |
| `SSL connection required`              | Il server richiede crittografia ma è disattivata    | Attiva Crittografa connessione                                    |
| Autenticazione Windows non disponibile | Host non Windows o Native Client assente            | Passa all'autenticazione SQL Server o installa Native Client 11.0 |