Azure Logic Apps'teki iş akışlarından bir olay hub'ına Bağlan

Şunlar için geçerlidir: Azure Logic Apps (Tüketim)

Azure Event Hubs bağlayıcısı, mantıksal uygulama iş akışlarınızı Azure'daki olay hub'larına bağlamanıza yardımcı olur. Daha sonra iş akışlarınızın bir olay hub'ına gönderilen olayları izlemesini ve yönetmesini sağlayabilirsiniz. Örneğin, iş akışınız olay hub'ınızdaki olayları denetleyebilir, gönderebilir ve alabilir. Bu makalede, bir olay hub'ına bağlanma ve iş akışınıza Event Hubs tetikleyicisi veya eylemi ekleme adımlarını göstererek Azure Event Hubs bağlayıcısını kullanmaya başlama kılavuzu sağlanır.

Azure Event Hubs veya Azure Logic Apps hakkında daha fazla bilgi için Bkz . Azure Event Hubs nedir veya Azure Logic Apps nedir?

Kullanılabilir işlemler

Özellikler, sınırlar vb. gibi tüm işlemler ve diğer teknik bilgiler için Event Hubs bağlayıcısının başvuru sayfasını gözden geçirin.

Dekont

Tümleştirme hizmeti ortamında (ISE) barındırılan mantıksal uygulamalar için bağlayıcının ISE sürümü bunun yerine ISE ileti sınırlarını kullanır.

Önkoşullar

İzinleri denetleme ve bağlantı dizesi alma

İş akışınızın olay hub'ınıza erişebildiğinden emin olmak için izinlerinizi denetleyin ve olay hub'ınızın ad alanı için bağlantı dizesi alın.

  1. Azure portalında belirli bir olay hub'ına değil Event Hubs ad alanınıza gidin.

  2. Ad alanı menüsündeki Ayarlar altında Paylaşılan erişim ilkeleri'ni seçin. Talepler sütununda, bu ad alanı için en azından Yönet izinlerine sahip olup olmadığınızı denetleyin.

    Screenshot showing the Azure portal, your Event Hubs namespace, and

  3. Daha sonra bağlantı bilgilerinizi el ile girmek istiyorsanız olay hub'ı ad alanınızın bağlantı dizesi alın.

    1. İlke sütununda RootManageSharedAccessKey'i seçin.

    2. Birincil anahtarınızın bağlantı dizesi bulun. daha sonra kullanmak üzere bağlantı dizesi kopyalayın ve kaydedin.

      Screenshot showing the primary key's connection string with the copy button selected.

      Bahşiş

      bağlantı dizesi Event Hubs ad alanınızla mı yoksa belirli bir olay hub'ıyla mı ilişkilendirildiğinden emin olmak için bağlantı dizesi parametresinin EntityPath olmadığından emin olun. Bu parametreyi bulursanız, bağlantı dizesi belirli bir Event Hubs "varlığı" içindir ve iş akışınızla kullanılacak doğru dize değildir.

Olay hub'ı bağlantısı oluşturma

Event Hubs tetikleyicisini veya eylemini ilk kez eklediğinizde, olay hub'ınıza bir bağlantı oluşturmanız istenir.

  1. İstendiğinde aşağıdaki seçeneklerden birini belirleyin:

    • Aşağıdaki bağlantı bilgilerini sağlayın:

      Özellik Zorunlu Değer Açıklama
      Bağlantı Adı Evet <bağlantı adı> Bağlantınız için oluşturulacak ad
      Event Hubs Ad Alanı Evet <event-hubs-namespace> Kullanmak istediğiniz Event Hubs ad alanını seçin.
    • Önceden kaydettiğiniz bağlantı dizesi el ile girmek için Bağlantı bilgilerini el ile girin'i seçin. bağlantı dizesi nasıl bulacağınızı öğrenin.

  2. Henüz seçili değilse kullanılacak Event Hubs ilkesini seçin ve ardından Oluştur'u seçin.

    Screenshot showing the provided connection information with

  3. Bağlantınızı oluşturduktan sonra Olay Hub'ı ekle tetikleyicisi veya Olay Hub'ı ekle eylemiyle devam edin.

Event Hubs tetikleyicisi ekleme

Azure Logic Apps'te her iş akışının belirli bir koşul karşılandığında tetiklenen bir tetikleyiciyle başlaması gerekir. Tetikleyici her tetiklendiğinde Logic Apps hizmeti bir iş akışı örneği oluşturur ve iş akışındaki adımları çalıştırmaya başlar.

Aşağıdaki adımlarda tetikleyici eklemenin genel yolu açıklanmaktadır. Örneğin Olay Hub'ında olaylar kullanılabilir olduğunda. Bu örnekte, olay hub'ınızdaki yeni olayları denetleyebilen ve yeni olaylar mevcut olduğunda bir iş akışı çalıştırması başlatan bir tetikleyicinin nasıl ekleneceği gösterilmektedir.

  1. Logic Apps Tasarım Aracı, açık değilse boş mantıksal uygulama iş akışınızı açın.

  2. İşlem arama kutusuna yazın event hubs. Tetikleyiciler listesinden Olay Hub'ında olaylar kullanılabilir olduğunda adlı tetikleyiciyi seçin.

    Select trigger

  3. Olay hub'ınıza bağlantı oluşturmanız istenirse, istenen bağlantı bilgilerini sağlayın.

  4. Tetikleyicide, izlemek istediğiniz olay hub'ı hakkında bilgi sağlayın, örneğin:

    Özellik Zorunlu Açıklama
    Olay Hub'ı adı Evet İzlemek istediğiniz olay hub'ına ilişkin ad
    İçerik türü No Olayın içerik türü. Varsayılan değer: application/octet-stream.
    Tüketici grubu adı No Olayları okumak için kullanılacak Event Hubs tüketici grubunun adı. Belirtilmezse, varsayılan tüketici grubu kullanılır.
    En fazla olay sayısı No En fazla olay sayısı. Tetikleyici, bir ile bu özellik tarafından belirtilen olay sayısı arasında döndürür.
    Aralık Evet İş akışının sıklık temelinde ne sıklıkta çalıştığını açıklayan pozitif bir tamsayı
    Sıklık Evet Yinelenme için zaman birimi

    Diğer özellikler için Yeni parametre ekle listesini açın. Parametre seçildiğinde bu özellik tetikleyiciye eklenir, örneğin:

    Trigger properties

    Diğer özellikler

    Özellik Zorunlu Açıklama
    İçerik şeması No Olay hub'ınızdan okunacak olaylar için JSON içerik şeması. Örneğin, içerik şemasını belirtirseniz, iş akışını yalnızca şemayla eşleşen olaylar için tetikleyebilirsiniz.
    En düşük bölüm anahtarı No Okunacak en düşük bölüm kimliğini girin. Varsayılan olarak, tüm bölümler okunur.
    En fazla bölüm anahtarı No Okunacak en fazla bölüm kimliğini girin. Varsayılan olarak, tüm bölümler okunur.
    Saat dilimi No Bu tetikleyici UTC uzaklığını kabul etmediğinden yalnızca bir başlangıç saati belirttiğinizde geçerlidir. Uygulamak istediğiniz saat dilimini seçin.

    Daha fazla bilgi için bkz . Azure Logic Apps ile yinelenen görevler ve iş akışları oluşturma ve çalıştırma.

    Başlangıç saati No Şu biçimde bir başlangıç saati sağlayın:

    Saat dilimi seçerseniz YYYY-AA-GGThh:mm:ss

    -veya-

    Saat dilimi seçmezseniz YYYY-AA-GGThh:mm:ssZ

    Daha fazla bilgi için bkz . Azure Logic Apps ile yinelenen görevler ve iş akışları oluşturma ve çalıştırma.

  5. İşlemi tamamladığınızda tasarımcı araç çubuğunda Kaydet'i seçin.

  6. Şimdi tetikleyici çıkışlarını kullanarak diğer görevleri gerçekleştirebilmeniz için bir veya daha fazla eylem eklemeye devam edin.

    Örneğin, olayları kategori gibi belirli bir değere göre filtrelemek için, Olay gönder eyleminin yalnızca koşulunuza uyan olayları göndermesi için bir koşul ekleyebilirsiniz.

Yoklama davranışını tetikleme

Tüm Event Hubs tetikleyicileri uzun yoklama tetikleyicileridir. Bu davranış, tetikleyici tetiklendiğinde tetikleyicinin tüm olayları işlediği ve olay hub'ınızda daha fazla olayın görünmesi için 30 saniye beklediği anlamına gelir. Tasarım gereği, 30 saniye içinde hiçbir olay görünmezse tetikleyici atlanır. Aksi takdirde tetikleyici, olay hub'ınız boş olana kadar olayları okumaya devam eder. Sonraki tetikleyici yoklaması, tetikleyicinin özelliklerinde ayarladığınız yinelenme aralığına göre gerçekleşir.

Örneğin, tetikleyici dört bölümle ayarlandıysa, tetikleyicinin tüm bölümleri yoklamasını tamamlaması iki dakika kadar sürebilir. Bu gecikme süresi içinde hiçbir olay alınmazsa tetikleyici çalıştırması atlanır. Aksi takdirde tetikleyici, olay hub'ınız boş olana kadar olayları okumaya devam eder. Sonraki tetikleyici yoklaması, tetikleyicinin özelliklerinde belirttiğiniz yinelenme aralığına göre gerçekleşir.

İletilerin görüntülendiği belirli bölümleri biliyorsanız tetikleyicinin en büyük ve en düşük bölüm anahtarlarını ayarlayarak tetikleyiciyi yalnızca bu bölümden veya bu bölümlerden gelen olayları okuyacak şekilde güncelleştirebilirsiniz. Daha fazla bilgi için Event Hubs tetikleyicisi ekleme bölümünü gözden geçirin.

Denetim noktası davranışını tetikleme

Event Hubs tetikleyicisi bir olay hub'ında her bölümden olayları okuduğunda, tetikleyici, akış uzaklığı (bir bölümdeki olay konumu) ve tetikleyicinin olayları okuduğu bölümler hakkındaki bilgileri korumak için kendi durumunu kullanır.

İş akışınız her çalıştırıldığında tetikleyici, tetikleyici durumu tarafından tutulan akış uzaklığından başlayarak bir bölümden olayları okur. Hepsini bir kez deneme biçiminde tetikleyici, olay hub'ında her bölüm üzerinde yinelenir ve sonraki tetikleyici çalıştırmalarındaki olayları okur. Tek bir çalıştırma, aynı anda tek bir bölümden olayları alır.

Tetikleyici, depolamada bu denetim noktası özelliğini kullanmaz ve ek maliyetle sonuçlanmaz. Ancak önemli nokta, Event Hubs tetikleyicisinin güncelleştirilmesi tetikleyicinin durumunu sıfırlar ve bu da tetikleyicinin akışın başındaki olayları okumasına neden olabilir.

Event Hubs eylemi ekleme

Azure Logic Apps'te bir eylem tetikleyiciyi veya başka bir eylemi izler ve iş akışınızda bazı işlemler gerçekleştirir. Aşağıdaki adımlarda, olay gönderme gibi bir eylem eklemenin genel yolu açıklanmaktadır. Bu örnekte iş akışı, olay hub'ınızdaki yeni olayları denetleen bir Event Hubs tetikleyicisiyle başlar.

  1. Logic Apps Tasarım Aracı, henüz açık değilse mantıksal uygulama iş akışınızı açın.

  2. Tetikleyicinin veya başka bir eylemin altına yeni bir adım ekleyin.

    Mevcut adımlar arasına bir adım eklemek için farenizi ok üzerinde hareket ettirin. Görüntülenen artı işaretini (+) ve ardından Eylem ekle'yi seçin.

  3. İşlem arama kutusuna yazın event hubs. Eylemler listesinden Olayı gönder adlı eylemi seçin.

    Select

  4. Olay hub'ınıza bağlantı oluşturmanız istenirse, istenen bağlantı bilgilerini sağlayın.

  5. Eylemde, göndermek istediğiniz olaylar hakkında bilgi sağlayın.

    Özellik Zorunlu Açıklama
    Olay Hub'ı adı Evet Olayı göndermek istediğiniz olay hub'ı
    İçerik No Göndermek istediğiniz olayın içeriği
    Veri Erişimi No Gönderilecek uygulama özellikleri ve değerleri
    Bölüm anahtarı No Olayın nereye gönderileceğine ilişkin bölüm kimliği

    Diğer özellikler için Yeni parametre ekle listesini açın. Parametre seçildiğinde bu özellik eyleme eklenir, örneğin:

    Select event hub name and provide event content

    Örneğin, Event Hubs tetikleyicinizden çıkışı başka bir olay hub'ına gönderebilirsiniz:

    Send event example

  6. İşlemi tamamladığınızda tasarımcı araç çubuğunda Kaydet'i seçin.

Bağlayıcı başvurusu

Özellikler, sınırlar vb. gibi tüm işlemler ve diğer teknik bilgiler için Event Hubs bağlayıcısının başvuru sayfasını gözden geçirin.

Dekont

Tümleştirme hizmeti ortamında (ISE) barındırılan mantıksal uygulamalar için bağlayıcının ISE sürümü bunun yerine ISE ileti sınırlarını kullanır.

Sonraki adımlar