Connexion de portier Companion à Microsoft SQL Server (configuration correcte de l’hôte)

Règle de base

Syntaxe :
NomDuServeur ou AdresseIP,Port

Exemple :
192.168.1.50,1433

Incorrect :
192.168.1.50:1433 ❌

Configurations typiques

1. SQL Server sur la même machine (local)

localhost,1433

127.0.0.1,1433

2. SQL Server sur un serveur réseau (y compris ports personnalisés)

Si SQL Server fonctionne sur une autre machine du réseau :

Exemple avec port par défaut :
192.168.1.50,1433

Exemple avec port personnalisé (très courant chez les clients) :
192.168.1.50,50100

Si votre SQL Server est configuré avec un port statique personnalisé (par exemple 50100), ce port doit obligatoirement être utilisé.

3. Instance nommée (par exemple SQLEXPRESS)

Pour les instances nommées, utilisez :

SERVERNAME\SQLEXPRESS

Dans ce scénario :

Aucun port ne doit être spécifié manuellement
Le service SQL Browser (UDP 1434) est utilisé pour la découverte de l’instance
Le port réel de la base de données est résolu automatiquement
Le port résolu est souvent un port dynamique élevé (par exemple 50345)

Il n’est pas nécessaire de connaître ou de configurer manuellement ce port dynamique.

Pour plus de clarté et de simplicité, il n’est pas recommandé de combiner une instance nommée avec un port fixe dans une configuration standard.

Exigences techniques

Pour garantir une connexion réussie :

TCP/IP doit être activé dans SQL Server Configuration Manager
Le port SQL Server (par exemple 1433 ou un port personnalisé comme 50100) doit être ouvert dans le pare-feu
Le service SQL Browser doit être actif lors de l’utilisation d’instances nommées
Le port UDP 1434 ne doit pas être bloqué (nécessaire pour la découverte d’instance)
L’authentification SQL doit être activée si un login SQL est utilisé
Les droits d’accès à la base de données doivent être correctement configurés

Problèmes courants

La connexion échoue immédiatement
→ Utilisation d’un deux-points au lieu d’une virgule entre le serveur et le port

Délai d’expiration (timeout)
→ Pare-feu bloquant le port SQL (1433 ou port personnalisé)

Instance nommée introuvable
→ Service SQL Browser non actif

Instance nommée introuvable
→ Port UDP 1434 bloqué

Échec de connexion (login failed)
→ Identifiants incorrects

Échec de connexion (login failed)
→ Authentification SQL non activée

Fonctionne en local mais pas à distance
→ TCP/IP désactivé

Serveur introuvable
→ Service SQL Server non démarré

“Cannot connect to database 'X'. Switching to database 'master'.”
→ Base de données hors ligne, inexistante ou droits insuffisants

Explication du message

“Cannot connect to database 'X'. Switching to database 'master'.”

Ce message signifie :

La connexion au serveur SQL fonctionne
Mais la base de données cible configurée ne peut pas être ouverte

Causes fréquentes :

Nom de base de données mal orthographié
Base renommée ou supprimée
Base configurée en mode Offline
Base en état Restoring ou Recovery
Le login SQL ne possède pas les droits nécessaires

Dans ce cas, SQL Server se connecte au serveur mais bascule automatiquement vers la base par défaut « master ».

Résumé

Toujours utiliser une virgule entre le serveur et le port
Utiliser le port personnalisé s’il est configuré (par exemple 50100)
Pour les instances nommées, utiliser uniquement SERVERNAME\INSTANCENAME
SQL Browser gère automatiquement les ports dynamiques
S’assurer que le port UDP 1434 est ouvert pour les instances nommées

Correct :
192.168.1.50,50100

Incorrect :
192.168.1.50:50100