sys.dm_os_hosts (Transact-SQL)
Returns all the hosts currently registered in an instance of SQL Server. This view also returns the resources that are used by these hosts.
Column name |
Data type |
Description |
|---|---|---|
host_address |
varbinary(8) |
Internal memory address of the host object. |
type |
nvarchar(60) |
Type of hosted component. For example, SOSHOST_CLIENTID_SERVERSNI= SQL Server Native Interface SOSHOST_CLIENTID_SQLOLEDB = SQL Server Native Client OLE DB Provider SOSHOST_CLIENTID_MSDART = Microsoft Data Access Run Time |
name |
nvarchar(32) |
Name of the host. |
enqueued_tasks_count |
int |
Total number of tasks that this host has placed onto queues in SQL Server. |
active_tasks_count |
int |
Number of currently running tasks that this host has placed onto queues. |
completed_ios_count |
int |
Total number of I/Os issued and completed through this host. |
completed_ios_in_bytes |
bigint |
Total byte count of the I/Os completed through this host. |
active_ios_count |
int |
Total number of I/O requests related to this host that are currently waiting to complete. |
default_memory_clerk_address |
varbinary(8) |
Memory address of the memory clerk object associated with this host. For more information, see sys.dm_os_memory_clerks (Transact-SQL). |
Permissions
Requires VIEW SERVER STATE permission on the server.
Remarks
SQL Server allows components, such as an OLE DB provider, that are not part of the SQL Server executable to allocate memory and participate in non-preemptive scheduling. These components are hosted by SQL Server, and all resources allocated by these components are tracked. Hosting allows SQL Server to better account for resources used by components external to the SQL Server executable.
Relationship Cardinalities
From |
To |
Relationship |
|---|---|---|
sys.dm_os_hosts. default_memory_clerk_address |
sys.dm_os_memory_clerks. memory_clerk_address |
one to one |
sys.dm_os_hosts. host_address |
sys.dm_os_memory_clerks. host_address |
one to one |
Examples
The following example determines the total amount of memory committed by a hosted component.
SELECT h.type, SUM(single_pages_kb + multi_pages_kb) AS commited_memory
FROM sys.dm_os_memory_clerks AS mc
INNER JOIN sys.dm_os_hosts AS h
ON mc.memory_clerk_address = h.default_memory_clerk_address
GROUP BY h.type;