xp_sendmail (Transact-SQL)

Bağımsız değişkenler

• [ @recipients=] **'**recipients [ ;... n] '
  Noktalı virgüllerle ayrılmış posta alıcıları listesidir.

• [ @message=] 'message'
  Is the message body to be sent.messagecan be up to 8,000 bytes.

• [ @query=] 'query'
  Is a valid SQL Server query, the result of which is sent in mail.xp_sendmail uses a bound connection for the query parameter.The query connection made by SQL Mail is not blocked by locks held by the client that issues the xp_sendmail request.Buxp_sendmail tetikler. içinde kullanmak daha kolay The query statement, however, cannot refer to the inserted and deleted logical tables, because these tables are only available within a trigger.querycan be up to 8,000 bytes.

• [ @attachments=] 'attachments [ ;... n] '
  Noktalı virgülle ayrılmış bir posta iletisine eklemek için dosyaların listesi belirtilir.Kullanıyorsanız,@ sorgu parametre, @ attach_results@ ekleri TRUE, ise parametre eklemek posta iletisini. için yalnızca bir dosya belirtebilirsiniz Bu durumda, birden fazla dosya göndermek için çalıştırmalısınızxp_sendmail bağlı dosya her biri için ayrı ayrı

• [ @copy_recipients=] **'**copy_recipients [ ;... n] '
  Noktalı virgülle ayrılmış listesi postanın bir kopyasını alıcılarını tanımlayan iş.

• [ @blind_copy_recipients=] **'**blind_copy_recipients[ ;... n] '
  İsteğe bağlı bir noktalı virgülle ayrılmış listesini görme kopyasını posta alıcıları tanımlayan iş.

• [ @subject=] 'subject'
  Bir parametre posta konusunu belirleme iş.If subjectis not specified, "SQL Server Message" is the default.

• [ @type=] 'type'
  Giriş ileti türü MAPI adres tanımını temel alan:

  IP[ M|C ].Vendorname.subclass

  Iftypeolan NULL,xp_sendmail ileti türünü kullanan IPM.İleti türü ile başlatmakIPMposta gelen kutusunda görünen istemci ve bulunan veya okunanxp_findnextmsg.İleti türü ile başlatmakIPCposta istemcisinin gelen kutusunda görüntülenir ve olmalı bulunamadı veya ayarlayarak okumatypeparametre.Varsayılan değer NULL olur.SQL Mail ileti türünü desteklerIPMveIPC.

• [ @attach_results=] 'attach_value'
  İş sonucu belirleyen isteğe bağlı parametre küme sorguda postanın eklenmiş yerine, ekli dosya olarak posta ile gönderilmelidir.If**@ ekleri** NULL ve @ attach_results değil ise TRUE, attachmentsDosya adı olarak kullanılır, ilk dosya adı sonuçlar. If**@ ekleri** NULL ise, bir dosya adı oluşturulur bir .txt uzantısı. ile Başka bir deyişle, sonuç yanlış varsayılandır küme iletiye eklenir.

• [ @no_output=] 'output_value'
  Posta gönderir, ancak herhangi bir çıktı gönderilen posta istemci oturumuna dönmek isteğe bağlı parametre belirtilir.Varsayılan değer olan yanlış olduğu anlamına gelir, istemci oturumSQL Serveralan çıktı.

• [ @no_header=] 'header_value'
  Sorgu sonuçlar posta ile gönderir, ancak sorgu sonuçlar ile sütun başlık bilgilerini gönderme isteğe bağlı parametre belirtilir.Sütun başlık bilgilerini sorgu sonuçlar gönderilir; yanlış varsayılandır.

• [ @width=] width
  İsteğe bağlı parametre sorgusu için çıkış metnin çizgi genişliği ayarı iş.Bu parametre olan aynı**/wisql** yardımcı programı. biçiminde parametre Üretim sorguları için çıkış satır uzun, kullanınwidthileattach_resultsortadaki çıkış satırlarını. satır sonu olmayan çıkış göndermek içinVarsayılan genişliği 80 karakter olabilir.

• [ @separator=] 'separator'
  Sonuç, her sütun için sütun ayırıcı dize küme.Varsayılan olarak, sütun ayırıcı boş bir alandır.Sütun ayırıcı kullanımı, elektronik tablolar ve diğer uygulamalar sonuç daha kolay çözümleme sağlar.Örneğin kullanınseparatorileattach_resultsvirgülle ayrılmış değerler. dosya gönderme

• [ @echo_error=] 'echo_value'
  TRUE olduğunda, tüm sunucu iletileri veya sorgu çalışırken DB-Library hataların ve hata günlüğü için bunları yazmak yerine posta iletisine eklemek, SQL Mail neden olur.Ayrıca, verilen/etkilenen satırların posta iletisine eklenen satır sayısı.

  Not

  Zamanecho_errorise, TRUExp_sendmail posta başarıyla, DB-Library hataları veya iletileri karşılaşılan veya sorgu hiçbir sonuçlar. verir bile gönderilirse 0 (başarılı) durumunu verir.

• [ @set_user=] 'user'
  Sorgunun çalıştırılması gereken güvenlik bağlamını belirtilir.Ifkullanıcı belirtilmezse, varsayılan güvenlik bağlamını kullanıcısının çalışan xp_sendmail kullanır.

• [ @dbuse=] 'database'
  Sorgunun çalıştırılması gereken veritabanı içeriği belirtilir.Başka bir deyişle varsayılan veritabanı kullanıcı yerleştirilir, NULL, varsayılandır.

Dönüş Kodu Değerleri

0 (başarılı) veya 1 (hatası)

Sonuç Kümeleri

Zaman başarılıxp_sendmail bir iletiyi. verir

Remarks

The SQL Mail oturum gerekir başladı öncexp_sendmail is run.Oturumları otomatik olarak veya ile başlatılabilirxp_startmail.Hakkında daha fazla bilgi için küme otomatik olarak bir SQL Mail oturum Bkz:Genişletilmiş MAPI posta profillerini yapılandırma.Destekleyen tüm kullanıcılar için bir SQL Mail oturumSQL Serverörneğin, ancak bir seferde yalnızca bir kullanıcı gönderebilirsiniz bir ileti.Diğer kullanıcılar posta iletilerini otomatik olarak gönderme, açar ilk kullanıcının ileti gönderilinceye kadar bekleyin.

Ifquerybelirtilmişse,xp_sendmail oturumu için SQL Serveristemcisi ve belirtilen sorgu.SQL Mail için ayrı bir bağlantı sağlarSQL Serverbunu paylaştırma olarak özgün istemci bağlantı verme aynı bağlantı;xp_sendmail.

xp_sendmail güvenlik bağlamında çalışır SQL Server.Geçerli bir kullanıcıxp_sendmail dosyalar için ek bir posta iletisi, bir yöneticinin güvenlik bağlamında. erişebilirsiniz Kullanıcılar sistem yöneticileri dışında gereken erişimxp_sendmail ve ek dosyaları güvenli olmayan erişime karşı korumak istiyorsanız, Sistem Yöneticisi, xp_sendmail arar ve gerekli işlevleri sağlar; ancak, attachmentsparametre. göstermiyor bir saklı yordam oluşturabilirsiniz. Bu saklı yordam tanımlanmalıdırana veritabanı. Daha sonra Sistem Yöneticisi verir izni olmadan temel izni verilmesi gereken kullanıcılara saklı yordam Çalıştırxp_sendmail yordamı.

xp_sendmail ileti, bir sorgunun sonuç kümesi ve belirli alıcılar eki gönderir ve queryparametre. ilişkili bir bağlantı kullanır The query connection made by SQL Mail is not blocked by locks held by the client that issues the xp_sendmail request.Buxp_sendmail tetikler. içinde kullanmak daha kolay The query statement, however, cannot refer to the logical inserted and deleted tables that are only available within a trigger.

xp_sendmail tam xml. veri türünü desteklemiyor. Kullanan sorgularxmlveri türü biçimlendirilmiş yanlış.KullanımıVeritabanı postaiçeren elektronik posta göndermek içinXML data.

İzinler

Üyelik gerektirenSistem Yöneticisi sabit sunucu rolü, ancak yürütmek izinleri verilebilir diğer kullanıcıların. için Ancak güvenlik nedenleriyle, bu saklı yordam için izinleri üyelerine sınırlı olmasını öneririzSistem Yöneticisi sunucu sabit rolü.

Örnekler

C.Tek bir kullanıcıya ileti gönderme

EXEC master.dbo.xp_sendmail 
    @recipients=N'danw@Adventure-Works.com',
    @message=N'The master database is full.' ;

B.Birden çok alıcıya ileti gönderme

EXEC master.dbo.xp_sendmail 
    @recipients=N'danw@Adventure-Works.com;ashvinis@Adventure-Works.com',
     @message=N'The master database is full.',
     @copy_recipients=N'peterc@Adventure-Works.com',
     @subject=N'Master database status' ;
GO

C.sonuçlar gönderme

EXEC master.dbo.xp_sendmail 
    @recipients=N'danw@Adventure-Works.com',
    @query = N'EXEC sp_configure' ;
GO

D.sonuçlar eklenmiş bir dosyayı gönderme

EXEC master.dbo.xp_sendmail
    @recipients = N'danw@Adventure-Works.com', 
    @query = N'SELECT * FROM INFORMATION_SCHEMA.TABLES',
    @subject = N'SQL Server Report',
    @message = N'The contents of INFORMATION_SCHEMA.TABLES:',
    @attach_results = 'TRUE',
    @width = 250 ;

E.7,990 Bayt karakterden uzun ileti gönderme

CREATE TABLE ##mail_body(c1 NVARCHAR(4000)) ;

DECLARE @cmd VARCHAR(56) ;

INSERT ##mail_body(c1)
VALUES ('Put your long message here.') ;

SET @cmd = 'SELECT c1 FROM ##mail_body' ;

EXEC master.dbo.xp_sendmail 
    @recipients = 'danw@Adventure-Works.com', 
    @query = @cmd,
    @no_header= 'TRUE' ;

DROP TABLE ##mail_body ;

See Also

Reference