sp_procoption (Transact-SQL)

Gilt für:SQL Server

Legt die automatische Ausführung einer gespeicherten Prozedur fest oder löscht diese. Eine gespeicherte Prozedur, die auf die automatische Ausführung festgelegt ist, wird jedes Mal ausgeführt, wenn eine Instanz von SQL Server gestartet wird.

Transact-SQL-Syntaxkonventionen

Syntax

sys.sp_procoption
    [ @ProcName = ] N'ProcName'
    , [ @OptionName = ] 'OptionName'
    , [ @OptionValue = ] 'OptionValue'
[ ; ]

Argumente

[ @ProcName = ] N'ProcName'

Der Name der Prozedur, für die eine Option festgelegt werden soll. @ProcName ist nvarchar(776), ohne Standard.

[ @OptionName = ] 'OptionName'

Der Name der festzulegenden Option. @OptionName ist varchar(35), und der einzige mögliche Wert iststartup.

[ @OptionValue = ] 'OptionValue'

Gibt an, ob die Option auf (true oder on) oder deaktiviert (false oder offdeaktiviert ) festgelegt werden soll. @OptionValue ist varchar(12) ohne Standard.

Rückgabecodewerte

0 (Erfolg) oder Fehlernummer (Fehler).

Hinweise

Startprozeduren müssen sich dbo im Schema der master Datenbank befinden und dürfen keine Parameter enthaltenINPUT.OUTPUT Die Ausführung der gespeicherten Prozeduren beginnt, wenn alle Datenbanken wiederhergestellt sind und beim Start die Meldung "Die Wiederherstellung ist abgeschlossen" protokolliert wird.

Berechtigungen

Erfordert die Mitgliedschaft in der festen Serverrolle sysadmin .

Beispiele

Im folgenden Beispiel wird für eine Prozedur die automatische Ausführung festgelegt.

EXEC sp_procoption @ProcName = N'<procedure name>',
    @OptionName = 'startup',
    @OptionValue = 'on';

Im folgenden Beispiel wird die automatische Ausführung einer Prozedur verhindert.

EXEC sp_procoption @ProcName = N'<procedure name>',
    @OptionName = 'startup',
    @OptionValue = 'off';