Can I use a named instance in the SQL Server integration?

This page is not yet available in Spanish. We are working on its translation.
If you have any questions or feedback about our current translation project, feel free to reach out to us!

When connecting to a default instance in SQL Server, users specify the host name with the port (1433 by default) as the host value in the sqlserver.yaml file. When troubleshooting connection issues with SQL Server, determine whether you are connecting to a default instance or a named instance. Named instances can be connected using the $SERVER$INSTANCE_NAME syntax, but only if the SQL Server Browser service is enabled since this service provides the port the instance is on.

Here are the docs from Microsoft with more about the SQL Server Browser service:

https://technet.microsoft.com/en-us/library/ms181087(v=sql.105).aspx#Anchor_2

The SQL Server Browser service is required to use named instances and is disabled by default. Datadog recommends the approval of a system admin before enabling this service.

Once the SQL Server Browser service has been enabled, you can configure the sqlserver.yaml file to connect to a named instance by designating the named instance in the host value. For example:

instances:
  - host: $SERVER\$INSTANCENAME
PREVIEWING: rtrieu/product-analytics-ui-changes