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


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