Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
O Microsoft SQL Server (MS-SQL) tem um recurso chamado instâncias nomeadas. Esse recurso permite executar vários bancos de dados no mesmo host (ou em hosts agrupados) com configurações separadas. Cada instância de banco de dados é executada na própria porta. No entanto, ao usar clientes compatíveis com MS-SQL em execução no Windows, é possível se conectar por nome em vez de pelo número da porta. Por exemplo, se o nome do host for dbserver e a instância tiver o nome proddb, você vai se conectar usando o nome do host dbserver\proddb.
Como as instâncias nomeadas do MS-SQL se conectam
Seu cliente entra em contato com o host, nomeado na porta MS-SQL padrão (1433).
O MS-SQL responde com a porta da instância nomeada.
O cliente se conecta a essa porta.
O Looker não vai conseguir encontrar o número da porta de uma instância nomeada dessa forma. Quando o Looker se conecta a uma porta, ele espera poder executar consultas e não se conecta a nenhuma outra porta.
Como conectar uma instância nomeada do MS-SQL ao Looker
O MS-SQL escolhe uma porta aleatória na inicialização. Para que o Looker se conecte a uma instância nomeada do MS-SQL, você precisa encontrar a porta em que a instância nomeada está sendo executada:
Depois de encontrar a porta, insira o nome dela no campo Host:Port na configuração da conexão do banco de dados do Looker. Por exemplo, se a porta for 61499 e o host tiver o nome dbserver, a conexão no Looker vai ser assim:
host: dbserver
port: 61499
OBSERVAÇÃO:o nome do host do banco de dados não terá o formato dbserver\proddb, como se você estivesse se conectando pelo nome da instância.
É importante observar que o MS-SQL pode escolher uma porta diferente para a instância nomeada sempre que o servidor for reinicializado. Isso pode exigir que o MS-SQL mude as regras do firewall e reconfigure o Looker para usar a nova porta. Para evitar que as portas mudem, você pode atribuir uma porta estática à sua instância nomeada. Consulte Como atribuir uma porta estática a uma instância nomeada do SQL Server e evitar um problema comum para saber mais sobre o processo.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 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."]]
