sys.dm_exec_cursors (Transact-SQL)
Aplica-se: 
SQL Server
Retorna informações sobre os cursores que estão abertos em vários bancos de dados.
Sintaxe
dm_exec_cursors (session_id | 0 )
Argumentos
session_id | 0
ID da sessão. Se session_id for especificado, essa função retornará informações sobre cursores na sessão especificada.
Se 0 for especificado, esta função retornará informações sobre todos os cursores em todas as sessões.
Tabela retornada
| Nome da coluna | Tipo de dados | Descrição |
|---|---|---|
| session_id | int | ID da sessão que detém o cursor. |
| cursor_id | int | ID do objeto do cursor. |
| name | nvarchar(256) | Nome do cursor como definido pelo usuário. |
| properties | nvarchar(256) | Especifica as propriedades do cursor. Os valores das seguintes propriedades são concatenados para formar o valor desta coluna: Interface de declaração Tipo de cursor Simultaneidade de cursores Escopo do cursor Nível de aninhamento do cursor Por exemplo, o valor retornado nesta coluna pode ser "TSQL | Dinâmico | Otimista | Global (0)". |
| sql_handle | varbinary(64) | Identificador do texto do lote que declarou o cursor. |
| statement_start_offset | int | Número de caracteres no procedimento em lote ou armazenado atualmente em execução no qual a instrução atualmente em execução se inicia. Pode ser usado junto com a sql_handle, a statement_end_offset e a função de gerenciamento dinâmico sys.dm_exec_sql_text para recuperar a instrução em execução no momento para a solicitação. |
| statement_end_offset | int | Número de caracteres no procedimento em lote ou armazenado atualmente em execução no qual a instrução atualmente em execução termina. Pode ser usado junto com a sql_handle, a statement_start_offset e a função de gerenciamento dinâmico sys.dm_exec_sql_text para recuperar a instrução em execução no momento para a solicitação. |
| plan_generation_num | bigint | Um número de sequência que pode ser usado para distinguir entre instâncias de planos após uma recompilação. |
| creation_time | datetime | Carimbo de data e hora da criação do cursor. |
| is_open | bit | Especifica se o cursor está aberto. |
| is_async_population | bit | Especifica se o thread em segundo plano ainda está populando assincronamente um cursor KEYSET ou STATIC. |
| is_close_on_commit | bit | Especifica se o cursor foi declarado por meio de CURSOR_CLOSE_ON_COMMIT. 1 = O cursor será fechado quando a transação terminar. |
| fetch_status | int | Retorna o último status de busca do cursor. Esse é o último valor @@FETCH_STATUS retornado. |
| fetch_buffer_size | int | Retorna informações sobre o tamanho do buffer de busca. 1 = Cursores Transact-SQL. Pode ser definido como um valor mais alto para cursores de API. |
| fetch_buffer_start | int | No caso dos cursores FAST_FORWARD e DYNAMIC, retornará 0 se o cursor não estiver aberto ou se for posicionado antes da primeira linha. Caso contrário, ele retornará -1. No caso dos cursores STATIC e KEYSET, retornará 0, se o cursor não estiver aberto, e -1, se o cursor for posicionado antes da primeira linha. Caso contrário, retorna o número da linha onde está posicionado. |
| ansi_position | int | Posição de cursor dentro do buffer de busca. |
| worker_time | bigint | Tempo gasto, em microssegundos, pelos trabalhados que executam este cursor. |
| Lê | bigint | Número de leituras executadas pelo cursor. |
| Escreve | bigint | Número de gravações executadas pelo cursor. |
| dormant_duration | bigint | Milissegundos desde o início da última consulta (aberta ou de busca) neste cursor. |
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
A tabela a seguir fornece informações sobre a interface de declaração de cursor e inclui os valores possíveis para a coluna de propriedades.
| Propriedade | Descrição |
|---|---|
| API | O cursor foi declarado usando uma das APIs de acesso a dados (ODBC, OLEDB). |
| TSQL | O cursor foi declarado usando a sintaxe DECLARE CURSOR de Transact-SQL. |
A tabela a seguir fornece informações sobre o tipo de cursor e inclui os valores possíveis para a coluna de propriedades.
| Tipo | Descrição |
|---|---|
| Keyset | O cursor foi declarado como Keyset (conjunto de chaves). |
| Dinâmico | O cursor foi declarado como Dynamic (dinâmico). |
| Instantâneo | O cursor foi declarado como Snapshot (instantâneo) ou Static (estático). |
| Fast_Forward | O cursor foi declarado como Fast Forward (avanço rápido). |
A tabela a seguir fornece informações sobre o tipo de simultaneidade de cursores e inclui os valores possíveis para a coluna de propriedades.
| Simultaneidade | Descrição |
|---|---|
| Somente leitura | O cursor foi declarado como somente leitura. |
| Scroll Locks | O cursor usa bloqueios de rolagem. |
| Otimista | O cursor usa controle de simultaneidade otimista. |
A tabela a seguir fornece informações sobre o tipo de escopo de cursor e inclui os valores possíveis para a coluna de propriedades.
| Escopo | Descrição |
|---|---|
| Local | Especifica que o escopo do cursor é local para o lote, procedimento armazenado ou gatilho no qual o cursor foi criado. |
| Global | Especifica que o escopo do cursor é global para a conexão. |
Exemplos
R. Detectando cursores antigos
Este exemplo retorna informações sobre cursores que estiveram abertos no servidor por mais tempo que as 36 horas especificadas.
SELECT creation_time, cursor_id, name, c.session_id, login_name
FROM sys.dm_exec_cursors(0) AS c
JOIN sys.dm_exec_sessions AS s ON c.session_id = s.session_id
WHERE DATEDIFF(hh, c.creation_time, GETDATE()) > 36;
GO
Confira também
Exibições e funções de gerenciamento dinâmico (Transact-SQL)
Funções e exibições de gerenciamento dinâmico relacionadas à execução (Transact-SQL)
sys.dm_exec_sessions (Transact-SQL)