Share via


sys.dm_os_child_instances (Transact-SQL)

Returns a row for each user instance that has been created from the parent server instance.

Important

This feature will be removed in a future version of Microsoft SQL Server. Avoid using this feature in new development work, and plan to modify applications that currently use this feature.

The information returned from sys.dm_os_child_instances can be used to determine the state of each User Instance (heart_beat) and to obtain the pipe name (instance_pipe_name) that can be used to create a connection to the User Instance using SQL Server Management Studio or SQLCmd. You can only connect to a User Instance after it has been started by an external process, such as a client application. SQL management tools cannot start a User Instance.

Note

User Instances are a feature of SQL Server 2012 Express only.

Column

Data type

Description

owning_principal_name

nvarchar(256)

The name of the user that this user instance was created for.

owning_principal_sid

nvarchar(256)

SID (Security-Identifier) of the principal who owns this user instance. This matches Windows SID.

owning_principal_sid_binary  

varbinary(85)

Binary version of the SID for the user who owns the user Instance

instance_name

nvarchar(128)

The name of this user instance.

instance_pipe_name

nvarchar(260)

When a user instance is created, a named pipe is created for applications to connect to. This name can be used in a connect string to connect to this user instance.

os_process_id

Int

The process number of the Windows process for this user instance.

os_process_creation_date

Datetime

The date and time when this user instance process was last started.

heart_beat

nvarchar(5)

Current state of this user instance; either ALIVE or DEAD.

Permissions

Requires VIEW SERVER STATE permission on the server.

Remarks

For more information about dynamic management view, see Dynamic Management Views and Functions (Transact-SQL) in SQL Server Books Online.

See Also

Other Resources

User Instances for Non-Administrators