Sdílet prostřednictvím

sys.dm_external_script_execution_stats

Platí pro: SQL Server 2016 (13.x) a novější verze Azure SQL Managed Instance

Vrátí jeden řádek pro každý typ požadavku externího skriptu. Požadavky na externí skripty jsou seskupené podle podporovaného jazyka externího skriptu. Pro každou zaregistrovanou externí skriptovací funkci se vygeneruje jeden řádek. Funkce libovolného externího skriptu se nezaznamenávají, pokud je neodesílají nadřazený proces, například rxExec.

Poznámka:

Toto zobrazení dynamické správy (DMV) je k dispozici pouze v případě, že jste nainstalovali a povolili funkci, která podporuje spouštění externích skriptů. Další informace najdete v tématech R Services v SQL Serveru 2016, Machine Learning Services (R, Python) v SQL Serveru 2017 a novějších aslužbách Azure SQL Managed Instance Machine Learning Services.

Název sloupce Datový typ Description
language nvarchar Název registrovaného jazyka externího skriptu Každý externí skript musí zadat jazyk v požadavku na skript, aby se spustil přidružený spouštěč.
counter_name nvarchar Název registrované funkce externího skriptu Není nastavitelný na null.
counter_value integer Celkový počet instancí, které byla na serveru volána registrovaná funkce externího skriptu. Tato hodnota je kumulativní, počínaje časem, kdy byla funkce nainstalována v instanci, a nelze ji resetovat.

Povolení

Pro SQL Server 2019 (15.x) a předchozí verze vyžaduje oprávnění VIEW SERVER STATE na serveru.

Pro SQL Server 2022 (16.x) a novější verze vyžaduje na serveru oprávnění ZOBRAZIT STAV VÝKONU SERVERU.

Uživatelé, kteří spouštějí externí skripty, musí mít další oprávnění SPUSTIT LIBOVOLNÝ EXTERNÍ SKRIPT. Toto zobrazení dynamické správy ale můžou používat správci bez tohoto oprávnění.

Poznámky

Toto zobrazení dynamické správy je k dispozici pro interní telemetrii, která monitoruje celkové využití nové funkce spouštění externích skriptů poskytovaných v SQL Serveru. Služba telemetrie se spustí, když LaunchPad provede a zvýší čítač založený na disku při každém zavolání registrované funkce externího skriptu.

Obecně řečeno, čítače výkonu jsou platné pouze za předpokladu, že proces, který je vygeneroval, je aktivní. Proto dotaz na zobrazení dynamické správy nemůže zobrazit podrobná data pro služby, které byly zastaveny. Pokud například spouštěč spustí externí skript a přesto je rychle dokončí, konvenční zobrazení dynamické správy nemusí zobrazovat žádná data.

Čítače sledované tímto zobrazením dynamické správy se proto uchovávají ve spuštěném stavu a stav je sys.dm_external_script_requests zachován pomocí zápisů na disk, i když je instance vypnutá.

Hodnoty čítačů

V SQL Serveru 2016 (13.x) je jediným podporovaným externím jazykem R a požadavky na externí skripty zpracovává R Services (In-Database). V SQL Serveru 2017 (14.x) a novějších verzích a ve službě Azure SQL Managed Instance jsou podporovány externí jazyky R i Python a požadavky na externí skripty zpracovává služba Machine Learning Services.

V případě R tato zobrazení dynamické správy sleduje počet volání jazyka R provedených v instanci. Pokud je například rxLinMod volána a spuštěna paralelně, čítač se zvýší o 1.

Pro jazyk R představují hodnoty čítače zobrazené v poli counter_name názvy registrovaných funkcí ScaleR. Hodnoty v poli counter_value představují kumulativní počet instancí, které konkrétní funkce ScaleR.

V případě Pythonu tato zobrazení dynamické správy sleduje počet volání Pythonu provedených v instanci.

Počet začíná, když je funkce nainstalována a povolena v instanci, a je kumulativní, dokud soubor, který udržuje stav, odstraněn nebo přepsán správcem. Proto obecně není možné resetovat hodnoty v counter_value. Pokud chcete monitorovat využití podle relací, časů kalendáře nebo jiných intervalů, doporučujeme zaznamenat počty do tabulky.

Registrace externích skriptových funkcí v jazyce R

R podporuje libovolné skripty a komunita R poskytuje tisíce balíčků, z nichž každá má vlastní funkce a metody. Toto zobrazení dynamické správy však monitoruje pouze funkce ScaleR, které jsou nainstalovány s SQL Serverem 2016 (13.x) R Services.

Registrace těchto funkcí se provádí při instalaci funkce a zaregistrované funkce není možné přidat ani odstranit.

Examples

Zobrazení počtu skriptů R spuštěných na serveru

Následující příklad zobrazí kumulativní počet spuštění externích skriptů pro jazyk R.

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

Zobrazení počtu skriptů Pythonu spuštěných na serveru

Následující příklad zobrazí kumulativní počet spuštění externích skriptů pro jazyk Python.

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

Viz také

  • Last updated on