DBCC dllname (FREE) (Transact-SQL)

Artikel
04/26/2023

Entfernt die angegebene DLL einer erweiterten gespeicherten Prozedur aus dem Arbeitsspeicher.

Syntax

DBCC <dllname> ( FREE ) [ WITH NO_INFOMSGS ]

Hinweis

Informationen zum Anzeigen der Transact-SQL-Syntax für SQL Server 2014 oder früher finden Sie unter Dokumentation zu früheren Versionen.

Argumente

`<dllname>`

Der Name der DLL, die aus dem Arbeitsspeicher gelöscht werden soll

WITH NO_INFOMSGS

Alle Informationsmeldungen werden unterdrückt.

Bemerkungen

Wenn eine erweiterte gespeicherte Prozedur ausgeführt wird, wird die DLL so lange von der Instanz von SQL Server im Arbeitsspeicher gehalten, bis der Server heruntergefahren wird. Mithilfe dieser Anweisung kann eine DLL aus dem Arbeitsspeicher entfernt werden, ohne dass SQL Server heruntergefahren werden muss. Führen Sie sp_helpextendedproc aus, damit alle zum aktuellen Zeitpunkt von SQL Server geladenen DLL-Dateien angezeigt werden.

Resultsets

Wenn eine gültige DLL angegeben wird, gibt DBCC <dllname> (FREE) Folgendes zurück:

DBCC execution completed. If DBCC printed error messages, contact your system administrator.

Berechtigungen

Erfordert die Mitgliedschaft in der festen Serverrolle sysadmin oder der festen Datenbankrolle db_owner .

Beispiele

Bei dem folgenden Beispiel wird vorausgesetzt, dass xp_sample als xp_sample.dll implementiert ist und ausgeführt wurde. DBCC <dllname> (FREE) entfernt die Datei xp_sample.dll, die der erweiterten Prozedur xp_sample zugeordnet ist, aus dem Arbeitsspeicher.

DBCC xp_sample (FREE);