sysmail_help_profile_sp (Transact-SQL)

Artikel
2025-01-02

Gilt für: SQL Server

Führt Informationen zu mindestens einem Mailprofil auf.

Syntax

sysmail_help_profile_sp [ [ @profile_id = ] profile_id | [ @profile_name = ] 'profile_name' ]
[ ; ]

Argumente

[ @profile_id = ] profile_id

Die Profil-ID, für die Informationen zurückgegeben werden sollen. @profile_id ist int, mit einem Standardwert von NULL.

[ @profile_name = ] 'profile_name'

Der Profilname, zu dem Informationen zurückgegeben werden sollen. @profile_name ist "sysname" mit der Standardeinstellung "NULL.

Rückgabecodewerte

0 (erfolgreich) oder 1 Fehler.

Resultset

Gibt ein Resultset mit den folgenden Spalten zurück.

Spaltenname	Datentyp	BESCHREIBUNG
`profile_id`	int	Die Profil-ID für das Profil.
`name`	sysname	Der Profilname des Profils.
`description`	nvarchar(256)	Die Beschreibung des Profils.

Hinweise

Wenn ein Profilname oder eine Profil-ID angegeben wird, sysmail_help_profile_sp werden Informationen zu diesem Profil zurückgegeben. sysmail_help_profile_sp Andernfalls werden Informationen zu jedem Profil in der SQL Server-Instanz zurückgegeben.

Die gespeicherte Prozedur sysmail_help_profile_sp befindet sich in der msdb Datenbank und befindet sich im Besitz des dbo-Schemas . Die Prozedur muss mit einem dreiteiligen Namen ausgeführt werden, wenn die aktuelle Datenbank nicht msdbvorhanden ist.

Berechtigungen

Sie können Berechtigungen für dieses Verfahren erteilen EXECUTE , aber diese Berechtigungen können während eines SQL Server-Upgrades außer Kraft gesetzt werden.

Beispiele

A. Alle Profile auflisten

Im folgenden Beispiel werden alle Profile in der Instanz aufgelistet.

EXEC msdb.dbo.sysmail_help_profile_sp;

Es folgt ein Beispielresultset, das auf Zeilenlänge umformatiert wurde:

profile_id  name                          description
----------- ----------------------------- ------------------------------
56          AdventureWorks Administrator  Administrative mail profile.
57          AdventureWorks Operator       Operator mail profile.

B. Auflisten eines bestimmten Profils

Im folgenden Beispiel werden Informationen für das AdventureWorks Administrator-Profil aufgelistet.

EXEC msdb.dbo.sysmail_help_profile_sp
    @profile_name = 'AdventureWorks Administrator' ;