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

# Intégration SQL Server

> Écrivez les données extraites par Octoparse dans Microsoft SQL Server avec l’authentification Windows ou SQL Server et des connexions TLS chiffrées.

Écrivez directement les données extraites dans Microsoft SQL Server. L’authentification Windows et celle par compte SQL Server sont prises en charge.

***

## Prérequis

* Un Plan gratuit Octoparse ou supérieur
* Une instance SQL Server accessible à Octoparse par le réseau
* Un compte utilisateur disposant d’une autorisation d’écriture dans la base de données cible
* Pour l’authentification Windows : le client de bureau Octoparse doit s’exécuter sous Windows et SQL Server Native Client 11.0 doit être installé

***

## Configurer l’export

Renseignez les paramètres d’export dans l’ordre suivant :

**Nom de la configuration**

Donnez un nom à la configuration afin de pouvoir la réutiliser. La liste déroulante permet de sélectionner une configuration existante ou de saisir un nouveau nom pour en créer une.

**Informations de connexion**

| Champ                 | Description                                               | Valeur par défaut |
| --------------------- | --------------------------------------------------------- | ----------------- |
| Nom du serveur        | Hôte de la base de données, sous forme d’IP ou de domaine | —                 |
| Port                  | Numéro de port                                            | `1433`            |
| Authentification      | Méthode d’authentification, décrite ci-dessous            | —                 |
| Nom d’utilisateur     | Compte SQL Server                                         | —                 |
| Mot de passe          | Mot de passe du compte                                    | —                 |
| Chiffrer la connexion | Activer TLS                                               | Désactivé         |

**Options d’authentification :**

| Option                    | Description                                                                                            | Plateforme         |
| ------------------------- | ------------------------------------------------------------------------------------------------------ | ------------------ |
| SQL Server Authentication | Connexion avec un compte et un mot de passe de base de données                                         | Windows / macOS    |
| Windows Authentication    | Connexion en tant qu’utilisateur Windows actuellement connecté, sans nom d’utilisateur ni mot de passe | Windows uniquement |

Lorsque Windows Authentication est sélectionné, les champs Username et Password sont désactivés.

> **Chiffrer la connexion :** Azure SQL Database et de nombreuses instances SQL Server gérées exigent le chiffrement par défaut. Activez cette option.

**Nom de la base de données**

Après avoir renseigné les informations de connexion, cliquez sur la liste déroulante Nom de la base de données. Octoparse se connecte et répertorie les bases de données, à l’exception des bases système ; sélectionnez la cible.

**Table de la base de données**

Une fois la base sélectionnée, choisissez la table cible dans la liste déroulante Table de la base de données. Créez-la au préalable ; Octoparse en lit les colonnes afin d’associer les champs.

**Tester la connexion**

Cliquez sur **Tester la connexion** pour valider la connexion, puis sur **Exporter** pour démarrer.

***

## Modes d’écriture

### Ajouter (Insert)

Chaque export ajoute de nouvelles lignes à la fin de la table sans modifier les données existantes.

### Upsert (Insert ou Update)

Le traitement de chaque ligne est déterminé par la clé primaire indiquée : l’enregistrement est mis à jour s’il existe et inséré dans le cas contraire. Désignez la colonne de clé primaire lors de l’association des champs.

***

## Erreurs courantes

| Erreur                              | Cause                                                                  | Solution                                                                      |
| ----------------------------------- | ---------------------------------------------------------------------- | ----------------------------------------------------------------------------- |
| `Login failed for user`             | Identifiants incorrects                                                | Vérifiez de nouveau les identifiants                                          |
| `Cannot open database`              | Nom de base incorrect ou autorisations insuffisantes                   | Vérifiez le nom de la base de données et les autorisations du compte          |
| `Connection refused`                | Réseau inaccessible ou port incorrect                                  | Vérifiez les règles du pare-feu et le port d’écoute de SQL Server             |
| `SSL connection required`           | Le serveur exige le chiffrement, mais Encrypt connection est désactivé | Activez Encrypt connection                                                    |
| Windows Authentication indisponible | L’hôte n’est pas sous Windows ou Native Client n’est pas installé      | Passez à SQL Server Authentication ou installez SQL Server Native Client 11.0 |