SQL Alias best practices report by SPDocKit determines whether the SharePoint servers are configured to use SQL aliases. If not, it can introduce some manageability issues.

SQL Alias

Issue description

This check determines whether the SharePoint servers are configured to use SQL aliases. From SPDocKit version 7.3 onwards, this report checks if your service applications and content databases are using a SQL alias in their connection strings.
If your SQL alias is not configured correctly, it can introduce manageability issues.


An alias is an alternate name that can be used to make a connection. The alias encapsulates the required elements of a connection string and exposes them with a name chosen by the user. Aliases can be used with any client application. By creating server aliases, your client computer can connect to multiple servers using different network protocols, without having to specify the protocol and connection details for each one.

Aliases can be very useful for moving databases between different SQL servers and ease scaling out the SharePoint environment. We recommend that you group the databases based on the usage and purpose and define the aliases based on that. The following table can be used as an example of database distribution and grouping:

Env.SQL AliasHostPortInstancedescription
ProdDB_P_Config_Psql01.contoso.comTCP/1433defaultSharePointConfig (principal)
ProdDB_P_Service_Psql01.contoso.comTCP/1433defaultSharePoint Service App databases (principal)
ProdDB_P_Usage_Psql01.contoso.comTCP/1433defaultSharePointUsagedatabase (principal)
ProdDB_P_Search_Psql01.contoso.comTCP/1433defaultSharePoint Search Databases (principal)
ProdDB_P_Content_Psql01.contoso.comTCP/1433defaultSharePoint Contentdatabases (principal)
ProdDB_P_Config_Msql02.contoso.comTCP/1433defaultSharePointConfig (mirror)
ProdDB_P_Service_Msql02.contoso.comTCP/1433defaultSharePoint Service App databases (mirror)
ProdDB_P_Usage_Msql02.contoso.comTCP/1433defaultSharePointUsagedatabase (mirror)
ProdDB_P_Search_Msql02.contoso.comTCP/1433defaultSharePoint Search Databases (mirror)
ProdDB_P_Content_Msql02.contoso.comTCP/1433defaultSharePoint Contentdatabases (mirror)


There is no supported way to change connection parameters for some databases, like SharePoint Configuration Database. Therefore, configuring SQL Server aliases before deploying SharePoint is very important. To create a SQL alias, use SQL Server Client Network Utility by clicking Start > Run > CliConfg.exe.

Additional information

Additional information can be found in the TechNet article: