Partager via

Tester la connectivité OLE DB à SQL Server à l’aide d’un fichier UDL

S'applique à : SQL Server

Remarque

Avant de commencer la résolution des problèmes, vérifiez les prérequis et passez par la liste de contrôle.

Cet article explique comment créer un fichier UDL (Universal Data Link) et utiliser différents fournisseurs pour tester la connexion à une instance SQL Server via le fichier.

Créer un fichier UDL

Remarque

Un fichier UDL vous permet de tester la connectivité des fournisseurs ole DB (Object Linking and Embedding Database) à n’importe quelle base de données back-end indépendante d’une application complète. L’enregistrement d’un fichier UDL génère une chaîne de connexion bien formée, que vous pouvez utiliser pour créer les chaîne de connexion d’une application ou vérifier comment définir différentes propriétés. Pour obtenir la chaîne, ouvrez le fichier dans le Bloc-notes.

Pour créer un fichier UDL pour tester votre fournisseur OLE DB, procédez comme suit :

  1. Pour afficher les extensions de fichier dans Explorateur de fichiers, procédez comme suit :

    1. Sélectionnez Démarrer, puis entrez Explorateur de fichiers Options.

    2. Sélectionnez l’onglet Affichage , décochez l’option Masquer les extensions pour les types de fichiers connus, puis sélectionnez OK.

  2. Accédez au dossier dans lequel vous souhaitez créer un fichier UDL. Par exemple, C :\temp.

  3. Créez un fichier texte (tel que sqlconn.txt), puis renommez l’extension de .txt en .udl. (Sélectionner Oui au message d’avertissement concernant la modification de l’extension de nom de fichier.)

    Vous pouvez également utiliser le script PowerShell suivant pour créer sqlconn.udl dans votre dossier %temp%.

    clear
$ServerName = "(local)"
$UDL_String = "[oledb]`r`n; Everything after this line is an OLE DB initstring`r`nProvider=MSOLEDBSQL.1;Integrated Security=SSPI;Persist Security Info=False;User ID=`"`";Initial Catalog=`"`";Data Source=" + $ServerName + ";Initial File Name=`"`";Server SPN=`"`";Authentication=`"`";Access Token=`"`""
Set-Content -Path ($env:temp + "\sqlconn.udl") -Value $UDL_String -Encoding Unicode

#open the UDL
Invoke-Expression ($env:temp + "\sqlconn.udl")

Tester la connexion à l’aide du pilote OLE DB SQL Server

Microsoft OLE DB Driver pour SQL Server (MSOLEDBSQL) est le dernier pilote OLE DB SQL Server. Le pilote a de nouvelles fonctionnalités, telles que TLS 1.2 et 1.3, MultiSubnetFailover et les méthodes d’authentification Azure (ID Microsoft Entra). Nous recommandons ce pilote pour les bases de données SQL Server plus récentes.

Le fournisseur Microsoft OLE DB pour SQL Server (SQLOLEDB) est le fournisseur de connectivité OLE DB hérité. Il est intégré à Windows et peut se connecter à n’importe quelle version de SQL Server qui n’est pas configurée pour exiger des liaisons de canal TLS 1.2 ou 1.3.

Pour tester la connexion à l’aide du pilote ou du fournisseur Microsoft OLE DB pour SQL Server, procédez comme suit :

  1. Ouvrez le fichier UDL.

  2. Sélectionnez l’onglet Fournisseur , sélectionnez le pilote ou le fournisseur OLE DB que vous utilisez dans votre application, puis sélectionnez Suivant.

  3. Sous l’onglet Connexion , spécifiez le protocole réseau, le nom de domaine complet (FQDN) et le numéro de port sous Sélectionner ou entrer un nom de serveur. Par exemple, tcp:SQLProd01.contoso.com,1433

    Remarque

    Cette façon d’entrer le nom et le port du serveur évite les problèmes courants (tels que les problèmes de service SQL Server Browser) susceptibles d’interférer avec une connexion.

  4. Entrez d’autres propriétés sous l’onglet Connexion .

    Remarque

    La plupart des tests de connexion ne vous obligent pas à entrer un nom de base de données.

  5. Sélectionnez Tester la connexion.

Vous pouvez également sélectionner d’autres onglets et explorer d’autres paramètres de pilote. Une fois le test de connexion terminé, sélectionnez OK pour enregistrer le chaîne de connexion dans un fichier.

Tester la connexion à l’aide du fournisseur Microsoft OLE DB pour les pilotes ODBC

Pour tester les pilotes ODBC (Open Database Connectivity) à l’aide du fournisseur Microsoft OLE DB pour les pilotes ODBC, procédez comme suit :

  1. Ouvrez le fichier UDL.

  2. Sélectionnez fournisseur Microsoft OLE DB Provider>for ODBC Drivers>Next.

  3. Sous l’onglet Connexion , vous pouvez utiliser l’une des méthodes suivantes pour spécifier la source de données, puis entrer d’autres propriétés.

    • Entrez une valeur dans le champ Utiliser le nom de la source de données.

    • Entrez un chaîne de connexion sans DSN comme Driver={ODBC Driver 17 for SQL Server};Server=SQLProd01;Database=Northwind;Trusted_Connection=Yes.

  4. Sélectionnez Tester la connexion.

Tester des fournisseurs 32 bits sur des machines 64 bits

Pour tester la connexion des fournisseurs 32 bits dans les systèmes d’exploitation 64 bits, procédez comme suit :

  1. Dans la fenêtre d’invite de commandes, exécutez la commande suivante pour ouvrir l’invite de commandes 32 bits :

    %windir%\SysWoW64\cmd.exe

  2. Exécutez la commande suivante pour ouvrir le fichier UDL :

    C:\temp\test.udl

  3. Si vous voyez le fournisseur OLE DB Microsoft Jet 4.0 sous l’onglet Fournisseur , vous avez correctement chargé la boîte de dialogue 32 bits et pouvez maintenant sélectionner le fournisseur 32 bits pour tester la connexion.

Lancer un fichier UDL

Double-cliquez sur un fichier UDL pour le lancer. Le code suivant décrit le processus sous-jacent utilisé lors du lancement d’un fichier UDL.

L’interface utilisateur du fichier UDL est fournie par OLEDB32.DLL et hébergée dans RUNDLL32.EXE.

  • Pour les systèmes d’exploitation 32 bits ou pour les fournisseurs 64 bits sur les systèmes d’exploitation 64 bits, utilisez la commande suivante (en supposant C:\temp\test.udl:

    Rundll32.exe "C:\Program Files\Common Files\System\OLE DB\oledb32.dll",OpenDSLFile C:\temp\test.udl

  • Pour les fournisseurs 32 bits sur les systèmes d’exploitation 64 bits, utilisez la commande suivante :

    C:\Windows\SysWOW64\Rundll32.exe "C:\Program Files (x86)\Common Files\system\Ole DB\oledb32.dll",OpenDSLFile C:\temp\test.udl

L’extension de fichier .udl est mappée à la première commande. Pour les fournisseurs 32 bits sur les systèmes d’exploitation 64 bits, vous pouvez simplifier les choses en exécutant une invite de commandes 32 bits, puis en exécutant START C:\TEMP\TEST.UDL pour tester les fournisseurs 32 bits. Si vous le souhaitez, vous pouvez créer un mappage d’extension de fichier qui utilise la commande 32 bits.

Créer un mappage d’extension de fichier UDL32 32 bits

Si vous utilisez fréquemment des fournisseurs 32 bits sur un système d’exploitation 64 bits, vous pouvez mapper une nouvelle extension de fichier (par exemple, .udl32) pour lancer la boîte de dialogue UDL 32 bits en procédant comme suit.

Important

Cette section, méthode ou tâche contient des étapes qui vous indiquent comment modifier le registre. Cependant, des problèmes sérieux peuvent survenir si vous modifiez le registre de manière incorrecte. Par conséquent, veillez à suivre attentivement ces étapes. Pour pallier à toute éventualité, sauvegardez le Registre avant de le modifier afin de pouvoir le restaurer en cas de problème. Pour plus d’informations sur la sauvegarde et la restauration du Registre, consultez Comment sauvegarder et restaurer le Registre dans Windows.

  1. Copiez le script suivant dans le Bloc-notes et enregistrez-le en tant que udl32.reg.

    Windows Registry Editor Version 5.00

[HKEY_CLASSES_ROOT\.UDL32]
@="ft000001"

[HKEY_CLASSES_ROOT\ft000001]
@="Microsoft Data Link 32"
"BrowserFlags"=dword:00000008
"EditFlags"=dword:00000000

[HKEY_CLASSES_ROOT\ft000001\shell]
@="open"

[HKEY_CLASSES_ROOT\ft000001\shell\open]

[HKEY_CLASSES_ROOT\ft000001\shell\open\command]
@="C:\\Windows\\SysWOW64\\Rundll32.exe \"C:\\Program Files (x86)\\Common Files\\system\\Ole DB\\oledb32.dll\",OpenDSLFile %1"

[HKEY_CLASSES_ROOT\ft000001\shell\open\ddeexec]

  2. Double-cliquez sur le fichier .reg pour créer une clé de Registre, ce qui vous permet de lancer automatiquement des fichiers UDL32.

  3. Créez un fichier avec l’extension de fichier .udl32 . Par exemple, C :\temp\test.udl32.

  4. Double-cliquez sur test.udl32 pour lancer la boîte de dialogue UDL 32 bits. Par exemple, vous pouvez voir une boîte de dialogue semblable à ceci :

    Capture d’écran montrant un exemple de boîte de dialogue UDL 32 bits.

Conseils pour résoudre les problèmes de connexion

Vous pouvez utiliser les méthodes suivantes pour vérifier pourquoi la connexion échoue.

  • Modifiez le fournisseur.
  • Modifiez le protocole. Par exemple, tcp:, np: ou lpc:.
  • Testez la connexion avec ou sans le suffixe de domaine complet ou avec simplement l’adresse IP.
  • Supprimez le numéro de port et utilisez le nom de l’instance pour tester le service SQL Server Browser.

Pour chacune des méthodes ci-dessus, si une combinaison fonctionne et qu’une autre échoue, elle peut donner un indice quant au problème. Par exemple, lorsque vous utilisez la deuxième méthode, si le lpc: fonctionnement et le tcp: ne le fait pas, essayez d’activer le protocole TCP dans Gestionnaire de configuration SQL Server.

Voir aussi

Configuration UDL (Universal Data Link)

Remarque

Si cet article ne résout pas votre problème, vous pouvez vérifier les problèmes de connectivité dans SQL Server pour obtenir de l’aide supplémentaire.

  • Last updated on