Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Microsoft SQL Server (MS-SQL) propose une fonctionnalité appelée instances nommées. Cette fonctionnalité vous permet d'exécuter plusieurs bases de données sur le même hôte (ou sur des hôtes en cluster) avec des paramètres distincts. Chaque instance de base de données s'exécute sur son propre port. Toutefois, lorsque vous utilisez des clients compatibles avec MS-SQL exécutés sur Windows, vous pouvez vous connecter par nom plutôt que par numéro de port. Par exemple, si votre nom d'hôte est dbserver et que votre instance s'appelle proddb, vous devez vous connecter à l'aide du nom d'hôte dbserver\proddb.
Comment les instances nommées MS-SQL se connectent-elles ?
Votre client contacte l'hôte, nommé sur le port MS-SQL par défaut (1433).
MS-SQL répond avec le port de l'instance nommée.
Le client se connecte ensuite à ce port.
Looker ne pourra pas trouver le numéro de port d'une instance nommée de cette manière. Une fois que Looker se connecte à un port, il s'attend à pouvoir exécuter des requêtes et ne se connecte à aucun autre port.
Connecter une instance nommée MS-SQL à Looker
MS-SQL choisit un port au hasard au démarrage. Pour que Looker se connecte à une instance nommée MS-SQL, vous devez trouver le port sur lequel elle s'exécute:
L'article SQL Server - Finding TCP Port Number SQL Instance Is Listening On (SQL Server : trouver le numéro de port TCP sur lequel l'instance SQL écoute) décrit la méthode à suivre pour trouver le port. Bien que l'article date de 2012, la procédure est similaire pour les différentes versions de MS-SQL.
Une fois que vous avez trouvé le port, vous pouvez saisir son nom dans le champ Host:Port de la configuration de la connexion à la base de données de Looker. Par exemple, si le port est 61499 et que l'hôte est nommé dbserver, la connexion dans Looker se présente comme suit:
host: dbserver
port: 61499
REMARQUE:Le nom d'hôte de la base de données ne se présente pas sous la forme dbserver\proddb, comme ce serait le cas si vous vous connectiez par le nom de l'instance.
Il est important de noter que MS-SQL peut choisir un port différent pour l'instance nommée chaque fois que le serveur est redémarré. MS-SQL devra peut-être modifier les règles de pare-feu et reconfigurer Looker pour qu'il utilise le nouveau port. Pour éviter que les ports ne changent, vous pouvez choisir d'attribuer un port statique à votre instance nommée. Pour en savoir plus sur la procédure, consultez How to Assign a Static Port to a SQL Server Named Instance — and Avoid a Common Pitfall (Comment attribuer un port statique à une instance nommée SQL Server et éviter un écueil courant).
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/31 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Difficile à comprendre","hardToUnderstand","thumb-down"],["Informations ou exemple de code incorrects","incorrectInformationOrSampleCode","thumb-down"],["Il n'y a pas l'information/les exemples dont j'ai besoin","missingTheInformationSamplesINeed","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/07/31 (UTC)."],[],[],null,["# Connecting an MS-SQL named instance\n\nMicrosoft SQL Server (MS-SQL) has a feature called [**named instances**](https://serverfault.com/a/80771). This feature lets you run multiple databases on the same host (or clustered hosts) with separate settings. Each database instance runs on its own port. However, when using MS-SQL--aware clients running on Windows, you can connect by name instead of by port number. For example, if your hostname is `dbserver` and your instance is named `proddb`, you would connect using the hostname `dbserver\\proddb`.\n\n\nHow MS-SQL named instances connect\n----------------------------------\n\n\u003cbr /\u003e\n\n1. Your client contacts the host, named on the default MS-SQL port (1433).\n2. MS-SQL responds with the named instance's port.\n3. The client then connects to that port.\n\n\nLooker will be unable to find the port number of a named instance in this way. Once Looker connects to a port, it expects to be able to run queries and will not connect with any other port.\n\nHow to connect an MS-SQL named instance with Looker\n---------------------------------------------------\n\nMS-SQL chooses a random port at startup. For Looker to connect to an MS-SQL named instance, you will need to find the port the named instance is running on:\n\n- The article [SQL Server --- Finding TCP Port Number SQL Instance Is Listening On](http://sqlandme.com/2013/05/01/sql-server-finding-tcp-port-number-sql-instance-is-listening-on/) details the method for finding the port. Although the article is from 2012, the procedure is similar across the various versions of MS-SQL.\n- Once you've found the port, you can enter the port name in the [`Host:Port`](/looker/docs/connecting-to-your-db#host:port) field in Looker's database connection configuration. For example, if the port is `61499` and the host is named `dbserver`, the connection in Looker will look like this:\n\n \u003cbr /\u003e\n\n\n ```\n host: dbserver\n port: 61499\n ```\n\u003e ***NOTE:** The database hostname will **not** take the form `dbserver\\proddb`, as it would if you were connecting by the instance name.*\n- it is important to note that MS-SQL may choose a different port for the named instance whenever the server is rebooted. This could require MS-SQL to change firewall rules and reconfigure Looker to use the new port. To avoid ports changing, you can choose to assign a static port to your named instance; see [How to Assign a Static Port to a SQL Server Named Instance --- and Avoid a Common Pitfall](https://www.heelpbook.net/2015/how-to-assign-static-port-to-a-sql-server-named-instance/) for details on the process."]]
