Udostępnij za pośrednictwem

sysmail_add_profile_sp (Transact-SQL)

Dotyczy:SQL ServerAzure SQL Managed Instance

Tworzy nowy profil poczty bazy danych .

Transact-SQL konwencje składni

Składnia

sysmail_add_profile_sp [ @profile_name = ] 'profile_name'
    [ , [ @description = ] N'description' ]
    [ , [ @profile_id = ] new_profile_id OUTPUT ]
[ ; ]

Argumenty (w programowaniu)

[ @profile_name = ] 'profile_name'

Nazwa nowego profilu. @profile_name jest nazwą systemu bez wartości domyślnej.

Aby wysyłać wiadomości e-mail przy użyciu zadań agenta programu SQL Server w usłudze Azure SQL Managed Instance, agent programu SQL Server może używać tylko jednego profilu poczty bazy danych i musi być wywoływany .AzureManagedInstance_dbmail_profile Aby uzyskać więcej informacji i przykładowy skrypt, zobacz powiadomienia o zadaniach agenta SQL dla zarządzanej instancji Azure SQL.

[ @description = ] N'description'

Opcjonalny opis nowego profilu. @description to nvarchar(256), bez wartości domyślnej.

[ @profile_id = ] new_profile_id DANE WYJŚCIOWE

Zwraca identyfikator nowego profilu. @profile_id jest int z wartością domyślną NULL.

Zwracanie wartości kodu

0 (powodzenie) lub 1 (niepowodzenie).

Uwagi

Profil poczty bazy danych zawiera dowolną liczbę kont poczty bazy danych. Procedury składowane poczty bazy danych mogą odwoływać się do profilu według nazwy profilu lub identyfikatora profilu wygenerowanego przez tę procedurę. Aby uzyskać więcej informacji na temat dodawania konta do profilu, zobacz sysmail_add_profileaccount_sp.

Nazwę profilu i opis można zmienić za pomocą procedury sysmail_update_profile_spskładowanej , podczas gdy identyfikator profilu pozostaje stały dla okresu życia profilu.

Nazwa profilu musi być unikatowa w wystąpieniu aparatu bazy danych programu SQL Server lub procedura składowana zwraca błąd.

Procedura sysmail_add_profile_sp składowana znajduje się w msdb bazie danych i jest własnością schematu dbo . Procedura musi być wykonywana z trzyczęściową nazwą, jeśli bieżąca baza danych nie msdbjest .

Uprawnienia

Możesz udzielić EXECUTE uprawnień do tej procedury, ale te uprawnienia mogą zostać zastąpione podczas uaktualniania programu SQL Server.

Przykłady

Odp. Tworzenie nowego profilu

W poniższym przykładzie zostanie utworzony nowy profil poczty bazy danych o nazwie AdventureWorks Administrator.

EXECUTE msdb.dbo.sysmail_add_profile_sp
    @profile_name = 'AdventureWorks Administrator',
    @description = 'Profile used for administrative mail.';

B. Tworzenie nowego profilu, zapisywanie identyfikatora profilu w zmiennej

W poniższym przykładzie zostanie utworzony nowy profil poczty bazy danych o nazwie AdventureWorks Administrator. Przykład przechowuje numer identyfikatora profilu w zmiennej @profileId i zwraca zestaw wyników zawierający numer identyfikatora profilu dla nowego profilu.

DECLARE @profileId AS INT;

EXECUTE msdb.dbo.sysmail_add_profile_sp
    @profile_name = 'AdventureWorks Administrator',
    @description = 'Profile used for administrative mail.',
    @profile_id = @profileId OUTPUT;

SELECT @profileId;

Treści powiązane