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

# Integración con SQL Server

> Escribe los datos extraídos por Octoparse en Microsoft SQL Server mediante autenticación de Windows o SQL Server y conexiones cifradas con TLS.

Escribe los datos extraídos directamente en Microsoft SQL Server. Admite la autenticación de Windows y la autenticación con una cuenta de SQL Server.

***

## Requisitos previos

* Plan Gratuito de Octoparse o superior
* Una instancia de SQL Server a la que Octoparse pueda acceder a través de la red
* Una cuenta de usuario con permiso de escritura en la base de datos de destino
* Para la autenticación de Windows: el cliente de escritorio de Octoparse debe ejecutarse en Windows con SQL Server Native Client 11.0 instalado

***

## Configurar la exportación

Completa los ajustes de exportación en el siguiente orden:

**Nombre de la configuración**

Asigna un nombre a la configuración para poder reutilizarla más adelante. La lista desplegable te permite elegir una configuración existente o escribir un nombre nuevo para crear una.

**Detalles de la conexión**

| Campo               | Descripción                                                 | Valor predeterminado |
| ------------------- | ----------------------------------------------------------- | -------------------- |
| Nombre del servidor | Host de la base de datos (IP o dominio)                     | —                    |
| Puerto              | Número de puerto                                            | `1433`               |
| Autenticación       | Método de autenticación (consulta la información siguiente) | —                    |
| Nombre de usuario   | Cuenta de SQL Server                                        | —                    |
| Contraseña          | Contraseña de la cuenta                                     | —                    |
| Cifrar conexión     | Habilitar TLS                                               | Desactivado          |

**Opciones de autenticación:**

| Opción                      | Descripción                                                                                                                      | Plataforma      |
| --------------------------- | -------------------------------------------------------------------------------------------------------------------------------- | --------------- |
| Autenticación de SQL Server | Conectarse con una cuenta y una contraseña de la base de datos                                                                   | Windows / macOS |
| Autenticación de Windows    | Conectarse como el usuario de Windows que tiene la sesión iniciada actualmente, sin necesidad de nombre de usuario ni contraseña | Solo Windows    |

Cuando se selecciona la autenticación de Windows, los campos Nombre de usuario y Contraseña se deshabilitan.

> **Cifrar conexión:** Azure SQL Database y muchas instancias administradas de SQL Server requieren cifrado de forma predeterminada; activa esta opción.

**Nombre de la base de datos**

Después de completar los detalles de la conexión, haz clic en la lista desplegable Nombre de la base de datos. Octoparse se conecta y muestra las bases de datos (excepto las bases de datos del sistema); elige la de destino.

**Tabla de la base de datos**

Una vez seleccionada una base de datos, elige la tabla de destino en la lista desplegable Tabla de la base de datos. Crea la tabla de antemano; Octoparse lee sus columnas para asignar los campos.

**Probar conexión**

Haz clic en **Probar conexión** para validar la conexión y, después, haz clic en **Exportar** para comenzar.

***

## Modos de escritura

### Anexar (Insert)

Cada exportación agrega filas nuevas al final de la tabla sin afectar a los datos existentes.

### Upsert (Insertar o actualizar)

Decide qué hacer con cada fila en función de la clave primaria que especifiques: actualiza la fila si el registro existe e insértala si no existe. Designa la columna de clave primaria en la asignación de campos.

***

## Errores habituales

| Error                                  | Causa                                                               | Solución                                                                        |
| -------------------------------------- | ------------------------------------------------------------------- | ------------------------------------------------------------------------------- |
| `Login failed for user`                | Credenciales incorrectas                                            | Vuelve a verificar las credenciales                                             |
| `Cannot open database`                 | Nombre de la base de datos incorrecto o permisos insuficientes      | Confirma el nombre de la base de datos y los permisos de la cuenta              |
| `Connection refused`                   | No se puede acceder a la red o el puerto es incorrecto              | Comprueba las reglas del firewall y el puerto en el que escucha SQL Server      |
| `SSL connection required`              | El servidor requiere cifrado, pero Cifrar conexión está desactivado | Activa Cifrar conexión                                                          |
| Autenticación de Windows no disponible | Host que no es Windows o Native Client no está instalado            | Cambia a la autenticación de SQL Server o instala SQL Server Native Client 11.0 |