Azure Data Factory veya Azure Synapse işlem hattıyla e-posta gönderme

ŞUNLARA UYGULANIR: Azure Data Factory Azure Synapse Analytics

İpucu

Microsoft Fabric'daki Data Factory, daha basit bir mimariye, yerleşik yapay zekaya ve yeni özelliklere sahip yeni nesil Azure Data Factory. Veri tümleştirmeyi yeni kullanmaya başladıysanız Fabric Data Factory ile başlayın. Mevcut ADF iş yükleri veri bilimi, gerçek zamanlı analiz ve raporlama genelinde yeni özelliklere erişmek için Fabric yükseltebilir.

İşlem hattının yürütülmesi sırasında veya sonrasında genellikle bildirim göndermek gerekir. Bildirim, proaktif uyarı sağlar ve sorunları keşfetmek için reaktif izleme gereksinimini azaltır.  Bu makalede, bir Azure Data Factory veya Azure Synapse işlem hattından gelen e-posta bildirimlerini yapılandırma gösterilmektedir. 

Önkoşullar

  • Azure aboneliği. Azure aboneliğiniz yoksa başlamadan önce bir free hesabı oluşturun.
  • Standart mantıksal uygulama iş akışı. İşlem hattından e-posta göndermeyi tetikleme amacıyla iş akışını tanımlamak için Azure Logic Apps kullanırsınız. Standart mantıksal uygulama iş akışı oluşturma hakkında ayrıntılı bilgi için bkz . Örnek bir Standart mantıksal uygulama iş akışı oluşturma.

Mantıksal uygulamanızda e-posta iş akışını oluşturma

adlı SendEmailFromPipelinebir Standart mantıksal uygulama iş akışı oluşturun. When an HTTP request is received adlı İstek tetikleyicisini ekleyin ve Send an email (V2) adlı Office 365 Outlook eylemini ekleyin.

İstek tetikleyicisi ve E-posta gönder (V2) eylemiyle mantıksal uygulama iş akışı tasarımcısını gösterir.

İstek tetikleyicisinde Request Body JSON Schema özelliği için şu JSON'ı sağlayın:

{
    "properties": {
        "dataFactoryName": {
            "type": "string"
        },
        "message": {
            "type": "string"
        },
        "pipelineName": {
            "type": "string"
        },
        "receiver": {
            "type": "string"
        }
    },
    "type": "object"
}

İş akışı tasarımcısındaki İstek tetikleyicisi şu şekilde görünmelidir:

İstek Gövdesi JSON Şeması alanı doldurulmuş İstek tetikleyicisi için iş akışı tasarımcısını gösterir.

E-posta gönder (V2) eylemi için, istek Gövdesi JSON şemasındaki özellikleri kullanarak e-postayı nasıl biçimlendirmek istediğinizi özelleştirin:

E-posta gönder (V2) eylemi için iş akışı tasarımcısını gösterir.

İş akışını kaydedin. İş akışının Genel Bakış sayfasına gidin. Aşağıdaki resimde vurgulanan iş akışı URL'sini not edin:

İş Akışı URL'sinin vurgulandığı iş akışına Genel Bakış sayfasını gösterir.

Not

İş akışı URL'sini bulmak için yalnızca onu içeren mantıksal uygulamaya değil iş akışının kendisine göz atmalısınız. Mantıksal uygulama örneğinizin İş Akışları sayfasından iş akışını seçin ve genel bakış sayfasına gidin.

Mantıksal uygulama iş akışınızı tetikleyen bir işlem hattı oluşturma

Logic App iş akışını e-posta göndermek için oluşturduktan sonra, bir işlem hattından Web etkinliği kullanarak onu tetikleyebilirsiniz.

  1. Yeni bir işlem hattı oluşturun ve Web etkinliğini Genel kategorisinin altında bulup düzenleme tuvaline sürükleyin.

  2. Yeni Web1 etkinliğini ve ardından Ayarlar sekmesini seçin.

    Önceden oluşturduğunuz mantıksal uygulama iş akışının URL'sini URL alanında sağlayın.

    Aşağıdaki JSON'yi Gövde için sağlayın.

       {
        "message" : "This is a custom dynamic message from your pipeline with run ID @{pipeline().RunId}.",
        "dataFactoryName" : "@{pipeline().DataFactory}", 
        "pipelineName" : "@{pipeline().Pipeline}", 
        "receiver" : "@{pipeline().parameters.receiver}"
       }
    

    İşlem hatlarınızdaki olaylar için yararlı iletiler oluşturmak için dinamik ifadeleri kullanın. Buradaki JSON biçiminin mantıksal uygulamada tanımladığınız JSON biçimiyle eşleşir ve bunları gerektiği gibi özelleştirebilirsiniz.

    Mantıksal uygulama iş akışı URL'si ve JSON ileti gövdesiyle yapılandırılmış bir Web etkinliğine sahip işlem hattını gösterir.

  3. İşlem hattı özellikleri sayfasını seçmek için işlem hattı tasarımcısının arka plan alanını seçin ve Varsayılan değeri olarak bir e-posta adresi sağlayarak alıcı adlı yeni bir parametre ekleyin.

    Bu örnekte, rastgele olarak tanımladığımız bir işlem hattı parametresinden alıcı e-postası sağlıyoruz. Alıcı değeri herhangi bir ifadeden, hatta bağlı veri kaynaklarından alınabilir.

    İşlem hattı tasarımcısında alıcı parametresinin yapılandırmasını gösterir.

  4. İşlem hattınızı yayımlayın ve ardından e-postanın beklendiği gibi gönderildiğini onaylamak için manuel olarak tetikleyin.

    İşlem hattını el ile tetikleme işlemini gösterir.

Sistem değişkenleri ve ifadelerle dinamik iletiler ekleme

İletilerinizi dinamik hale getirmek için sistem değişkenlerini ve ifadelerini kullanabilirsiniz. Örneğin:

  • @activity("CopyData").output.errors[0].Message

  • @activity("DataFlow").error.Message

Yukarıdaki ifadeler, bir Kopyalama etkinliği hatasından gelen ilgili hata iletilerini döndürür ve bu iletiler daha sonra e-postayı gönderen Web etkinliğinize yönlendirilebilir. Daha fazla ayrıntı için Kopyalama etkinliği çıktı özellikleri makalesine bakın.