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

Ş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.

Ö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ünde, Ayarlar'ın 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.

    Azure portalını, Event Hubs ad alanınızı ve

  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.

      Birincil anahtarın kopyala düğmesinin seçili olduğu bağlantı dizesi gösteren ekran görüntüsü.

      İpucu

      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ı Yes <bağlantı adı> Bağlantınız için oluşturulacak ad
      Event Hubs Ad Alanı Yes <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.

  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ımcısı'nda, 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.

    Tetikleyiciyi seçin

  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ı Yes İzlemek istediğiniz olay hub'ına ilişkin ad
    İçerik türü Hayır Olayın içerik türü. Varsayılan değer: application/octet-stream.
    Tüketici grubu adı Hayır 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ı Hayır En fazla olay sayısı. Tetikleyici, bir ile bu özellik tarafından belirtilen olay sayısı arasında döndürür.
    Aralık Yes İş akışının sıklık temelinde ne sıklıkta çalıştığını açıklayan pozitif bir tamsayı
    Sıklık Yes 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:

    Tetikleyici özellikleri

    Diğer özellikler

    Özellik Zorunlu Açıklama
    İçerik şeması Hayır 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ı Hayır 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ı Hayır Okunacak en fazla bölüm kimliğini girin. Varsayılan olarak, tüm bölümler okunur.
    Saat dilimi Hayır 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 Hayır Ş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ımcısı'nda, 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.

  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ı Yes Olayı göndermek istediğiniz olay hub'ı
    İçerik Hayır Göndermek istediğiniz olayın içeriği
    Veri Erişimi Hayır Gönderilecek uygulama özellikleri ve değerleri
    Bölüm anahtarı Hayır 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:

    Olay hub'ı adını seçin ve olay içeriği sağlayın

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

    Olay gönderme örneği

  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.

Sonraki adımlar