sys.dm_os_child_instances (Transact-SQL)
Aplica-se a:
SQL Server Azure Synapse Analytics Analytics Platform System (PDW)
Retorna uma linha para cada instância de usuário que foi criada a partir da instância do servidor pai.
Importante
Esse recurso será removido em uma versão futura do SQL Server. Evite usar esse recurso em desenvolvimentos novos e planeje modificar os aplicativos que atualmente o utilizam.
As informações retornadas de sys.dm_os_child_instances podem ser usadas para determinar o estado de cada Instância de Usuário (heart_beat) e para obter o nome do pipe (instance_pipe_name) que pode ser usado para criar uma conexão com a Instância de Usuário usando SQL Server Management Studio ou SQLCmd. Será possível conectar-se a uma Instância de Usuário somente depois que ela for iniciada por um processo externo, como um aplicativo cliente. As ferramentas de gerenciamento SQL não podem iniciar uma Instância de Usuário.
Observação
As Instâncias de Usuário são apenas um recurso do SQL Server 2012 Express.
Observação
Para chamar isso do Azure Synapse Analytics ou do PDW (Analytics Platform System), use o nome sys.dm_pdw_nodes_os_child_instances. Não há suporte a essa sintaxe para o pool de SQL sem servidor no Azure Synapse Analytics.
| Coluna | Tipo de dados | Descrição |
|---|---|---|
| owning_principal_name | nvarchar(256) | O nome do usuário para o qual esta instância de usuário foi criada. |
| owning_principal_sid | nvarchar(256) | SID (Identificador de Segurança) da entidade que possui esta instância de usuário. Isto corresponde ao SID do Windows. |
| owning_principal_sid_binary | varbinary(85) | Versão binária do SID do usuário que possui a Instância de usuário |
| instance_name | nvarchar(128) | O nome desta instância de usuário. |
| instance_pipe_name | nvarchar(260) | Quando uma instância de usuário for criada, um pipe nomeado será criado para que aplicativos se conectem. Esse nome pode ser usado em uma cadeia de caracteres de conexão a fim de conectar a esta instância de usuário. |
| os_process_id | Int | O número do processo do Windows para esta instância de usuário. |
| os_process_creation_date | Datetime | A data e a hora em que este processo de instância de usuário foi iniciado pela última vez. |
| heart_beat | nvarchar(5) | Estado atual desta instância de usuário; ALIVE ou DEAD. |
| pdw_node_id | int | Aplica-se a: Azure Synapse Analytics, Analytics Platform System (PDW) O identificador do nó em que essa distribuição está ativada. |
Permissões
, é necessário ter permissão VIEW SERVER STATE no servidor.
Permissões do SQL Server 2022 e posteriores
É necessária a permissão VIEW SERVER PERFORMANCE STATE no servidor.
Comentários
Para obter mais informações sobre o modo de exibição de gerenciamento dinâmico, consulte Modos de exibição e funções de gerenciamento dinâmico (Transact-SQL) nos Manuais Online do SQL Server.