sys.dm_os_child_instances (Transact-SQL)

  • Artigo

Aplica-se a:SQL ServerAzure Synapse AnalyticsAnalytics 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 do 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 o SQL Server Management Studio ou o 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 um recurso somente do SQL Server 2012 Express.

Observação

Para chamar isso do Azure Synapse Analytics ou do Analytics Platform System (PDW), 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 Exibições e funções de gerenciamento dinâmico (Transact-SQL) nos Manuais Online do SQL Server.

Confira também

Instâncias de usuário para não administradores