Partilhar via

sys.dm_external_script_execution_stats

Aplica-se a: SQL Server 2016 (13.x) e versões posteriores Instância Gerenciada SQL do Azure

Retorna uma linha para cada tipo de solicitação de script externo. As solicitações de script externo são agrupadas pela linguagem de script externa suportada. Uma linha é gerada para cada função de script externa registrada. Funções de script externas arbitrárias não são registradas, a menos que sejam enviadas por um processo pai, como rxExec.

Observação

Essa exibição de gerenciamento dinâmico (DMV) estará disponível somente se você tiver instalado e habilitado o recurso que oferece suporte à execução de scripts externos. Para obter mais informações, consulte R Services no SQL Server 2016, Serviços de Machine Learning (R, Python) no SQL Server 2017 e posterior e Serviços de Aprendizado de Máquina de Instância Gerenciada SQL do Azure.

Nome da coluna Tipo de dados Description
language nvarchar Nome da linguagem de script externa registrada. Cada script externo deve especificar o idioma na solicitação de script para iniciar o iniciador associado.
counter_name nvarchar Nome de uma função de script externa registrada. Não é anulável.
counter_value integer Número total de instâncias que a função de script externo registrada foi chamada no servidor. Esse valor é cumulativo, começando com a hora em que o recurso foi instalado na instância, e não pode ser redefinido.

Permissions

Para SQL Server 2019 (15.x) e versões anteriores, requer a permissão VIEW SERVER STATE no servidor.

Para o SQL Server 2022 (16.x) e versões posteriores, requer a permissão VIEW SERVER PERFORMANCE STATE no servidor.

Os usuários que executam scripts externos devem ter a permissão adicional EXECUTE QUALQUER SCRIPT EXTERNO. No entanto, este Detran pode ser usado por administradores sem essa permissão.

Observações

Este DMV é fornecido para telemetria interna, para monitorar o uso geral do novo recurso de execução de script externo fornecido no SQL Server. O serviço de telemetria é iniciado quando o LaunchPad o faz e incrementa um contador baseado em disco cada vez que uma função de script externa registrada é chamada.

De um modo geral, os contadores de desempenho são válidos apenas enquanto o processo que os gerou estiver ativo. Portanto, uma consulta em um Detran não pode mostrar dados detalhados de serviços que pararam de ser executados. Por exemplo, se um iniciador executa scripts externos e ainda os completa rapidamente, um Detran convencional pode não mostrar nenhum dado.

Portanto, os contadores rastreados por esse Detran são mantidos em execução e o estado for sys.dm_external_script_requests é preservado usando gravações no disco, mesmo que a instância seja desligada.

Valores do contador

No SQL Server 2016 (13.x), o único idioma externo com suporte é R e as solicitações de script externo são tratadas pelo R Services (In-Database). No SQL Server 2017 (14.x) e versões posteriores, e na Instância Gerenciada SQL do Azure, R e Python têm suporte para linguagens externas e as solicitações de script externo são tratadas pelos Serviços de Aprendizado de Máquina.

Para R, este Detran rastreia o número de chamadas R que são feitas em uma instância. Por exemplo, se rxLinMod for chamado e executado em paralelo, o contador aumentará em 1.

Para a linguagem R, os valores do contador exibidos no campo counter_name representam os nomes das funções ScaleR registradas. Os valores no campo counter_value representam o número cumulativo de instâncias que a função ScaleR específica.

Para Python, este DMV rastreia o número de chamadas Python que são feitas em uma instância.

A contagem começa quando o recurso é instalado e habilitado na instância e é cumulativa até que o arquivo que mantém o estado seja excluído ou substituído por um administrador. Portanto, geralmente não é possível redefinir os valores em counter_value. Se você quiser monitorar o uso por sessão, horários do calendário ou outros intervalos, recomendamos capturar as contagens em uma tabela.

Registo de funções de script externo em R

R suporta scripts arbitrários, e a comunidade R fornece milhares de pacotes, cada um com suas próprias funções e métodos. No entanto, esse DMV monitora apenas as funções do ScaleR instaladas com o SQL Server 2016 (13.x) R Services.

O registro dessas funções é realizado quando o recurso é instalado e as funções registradas não podem ser adicionadas ou excluídas.

Examples

Exibir o número de scripts R executados no servidor

O exemplo a seguir exibe o número cumulativo de execuções de script externo para a linguagem R.

SELECT counter_name, counter_value
FROM sys.dm_external_script_execution_stats
WHERE language = 'R';

Visualize o número de scripts Python executados no servidor

O exemplo a seguir exibe o número cumulativo de execuções de script externo para a linguagem Python.

SELECT counter_name, counter_value
FROM sys.dm_external_script_execution_stats
WHERE language = 'Python';

Consulte também

  • Last updated on