Aracılığıyla paylaş

sysmail_add_profile_sp (Transact-SQL)

Şunlar için geçerlidir:SQL ServerAzure SQL Yönetilen Örneği

Yeni bir Veritabanı Posta profili oluşturur.

Transact-SQL söz dizimi kuralları

Sözdizimi

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

Tartışmalar

[ @profile_name = ] 'profile_name'

Yeni profilin adı. @profile_namesysname'dir ve varsayılan değer yoktur.

Azure SQL Yönetilen Örneği'nde SQL Server Aracısı işlerini kullanarak e-posta göndermek için, SQL Server Aracısı yalnızca bir Veritabanı Posta profili kullanabilir ve çağrılmalıdır AzureManagedInstance_dbmail_profile. Daha fazla bilgi ve örnek betik için bkz. Azure SQL Yönetilen Örneği SQL Aracısı iş bildirimleri.

[ @description = ] N'açıklama'

Yeni profil için isteğe bağlı açıklama. @descriptionnvarchar(256) şeklindedir ve varsayılan değer yoktur.

[ @profile_id = ] new_profile_id ÇıKıŞ

Yeni profilin kimliğini döndürür. @profile_id, varsayılan değeri olan int'tirNULL.

Dönüş kodu değerleri

0 (başarı) veya 1 (başarısızlık).

Açıklamalar

Veritabanı Posta profili, herhangi bir sayıda Veritabanı Postası hesabı barındırıyor. Veritabanı Posta saklı yordamları, profil adına veya bu yordam tarafından oluşturulan profil kimliğine göre bir profile başvurabilir. Profile hesap ekleme hakkında daha fazla bilgi için bkz. sysmail_add_profileaccount_sp.

Profil adı ve açıklaması saklı yordamla sysmail_update_profile_spdeğiştirilebilir, profil kimliği ise profilin ömrü boyunca sabit kalır.

Profil adı SQL Server Veritabanı Altyapısı örneğinde benzersiz olmalıdır veya saklı yordam bir hata döndürür.

Saklı yordam sysmail_add_profile_sp veritabanındadır msdb ve şemaya dbo aittir. Geçerli veritabanı msdbdeğilse, yordamın üç parçalı bir adla yürütülmesi gerekir.

İzinler

Bu yordamda EXECUTE izinler vekleyebilirsiniz, ancak bu izinler SQL Server yükseltmesi sırasında geçersiz kılınabilir.

Örnekler

A. Yeni profil oluşturma

Aşağıdaki örnek adlı AdventureWorks Administratoryeni bir Veritabanı Posta profili oluşturur.

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

B. Profil kimliğini bir değişkene kaydederek yeni profil oluşturma

Aşağıdaki örnek adlı AdventureWorks Administratoryeni bir Veritabanı Posta profili oluşturur. Örnek, profil kimliği numarasını değişkende @profileId depolar ve yeni profilin profil kimlik numarasını içeren bir sonuç kümesi döndürür.

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;

İlgili içerik

  • Last updated on