Service Bus'ta veri işlemlerini çalıştırmak için Service Bus Gezgini'ni kullanma

  • Makale

Azure Service Bus, gönderen ve alıcı istemci uygulamalarının tanıdık noktadan noktaya (Kuyruk) ve yayımlama-abone olma (Konu Aboneliği) semantiği kullanarak iş mantığını ayırmasına olanak tanır.

Dekont

Bu makalede, Azure portalının parçası olan Azure Service Bus Gezgini'nin işlevselliği vurgulanır.

Topluluğa ait açık kaynak Service Bus Gezgini tek başına bir uygulamadır ve bu uygulamadan farklıdır.

Azure Service Bus ad alanında çalıştırılacak işlemler iki türdedir.

  • Yönetim işlemleri - Service Bus ad alanını, kuyrukları, konuları ve abonelikleri oluşturun, güncelleştirin, silin.
  • Veri işlemleri - Kuyruklara, konulara ve aboneliklere ileti gönderin ve bu iletilerden ileti alın.

Önemli

  • Service Bus Gezgini yönetim işlemlerini ve oturumlarını desteklemez.
  • İleti boyutuna, istemci ile Service Bus hizmeti arasındaki ağ gecikme süresine bağlı olarak zaman aşımlarına neden olabileceğinden, daha büyük iletiler için Service Bus Gezgini'ni kullanmanızı öneririz. Bunun yerine, kendi zaman aşımı değerlerinizi belirtebileceğiniz daha büyük iletilerle çalışmak için kendi istemcinizi kullanmanızı öneririz.

Önkoşullar

Service Bus Gezgini aracını kullanmak için aşağıdaki görevleri gerçekleştirmeniz gerekir:

Service Bus Gezgini'ni kullanma

Service Bus Gezgini'ni kullanmak için, üzerinde veri işlemleri yapmak istediğiniz Service Bus ad alanına gidin.

  1. Kuyrukta işlem çalıştırmak istiyorsanız gezinti menüsünden Kuyruklar'ı seçin. Bir konu başlığında (ve ilgili aboneliklerde) işlem çalıştırmak istiyorsanız Konular'ı seçin.

    Screenshot of left side navigation, where entity can be selected.

  2. Kuyruklar veya Konular'ı seçtikten sonra belirli bir kuyruğu veya konuyu seçin.

    Screenshot of the Queues page with a specific queue selected.

  3. Sol gezinti menüsünden Service Bus Gezgini'ni seçin

    Screenshot of queue page where Service Bus Explorer can be selected.

    Dekont

    Bir aboneliğe göz atarken veya abonelikten alırken, önce açılan liste seçiciden belirli bir Aboneliği seçin. Screenshot of dropdown for topic subscriptions.

İletiye göz atma

Göz atma işleviyle Service Bus Gezgini'ni kullanarak kuyruk, abonelik veya teslim edilemeyen ileti kuyruğundaki en iyi 100 iletiyi görüntüleyebilirsiniz.

  1. İletilere göz atmak için Service Bus Gezgini açılan listesinde Göz Atma Modu'nu seçin.

    Screenshot of dropdown with Peek Mode selected.

  2. Göz atmak için Etkin İletiler veya Teslim Edilemeyen İletiler olup olmadığını görmek için ölçümleri denetleyin ve Kuyruk / Abonelik veya DeadLetter alt sırasını seçin.

    Screenshot of queue and dead-letter subqueue tabs with message metrics displayed.

  3. Başlangıç ekranından göz at düğmesini seçin.

    Screenshot indicating the Peek from start button.

  4. Göz atma işlemi tamamlandıktan sonra, aşağıdaki görüntüde gösterildiği gibi kılavuzda en fazla 100 ileti gösterilir. Belirli bir iletinin ayrıntılarını görüntülemek için kılavuzdan seçin. Gövdeyi veya ileti özelliklerini görüntülemeyi seçebilirsiniz.

    Screenshot with overview of peeked messages and message body content shown for peeked messages.

    Meta verileri görmek için alt bölmedeki İleti Özellikleri sekmesine geçin.

    Screenshot with overview of peeked messages and message properties shown for peeked messages.

    Dekont

    Göz atma yıkıcı bir işlem olmadığından ileti varlıktan kaldırılmaz .

    Dekont

    Performans nedenleriyle, en fazla ileti boyutu 1 MB'ın üzerinde ayarlanmış olan bir kuyruktan veya abonelikten gelen iletilere göz atarken, ileti gövdesi varsayılan olarak alınmaz. Bunun yerine, İleti gövdesini yükle düğmesine tıklayarak belirli bir iletinin ileti gövdesini yükleyebilirsiniz. İleti gövdesi 1 MB'ın üzerindeyse, görüntülenmeden önce kesilir. Screenshot with overview of peeked messages and button to load message body shown.

Gelişmiş seçeneklerle iletiye göz atma

Seçeneklerle göz atma işlevi, Service Bus Gezgini'ni kullanarak bir kuyrukta, abonelikte veya teslim edilemeyen ileti kuyruğunda en çok kullanılan iletileri görüntülemenize, göz atılacak ileti sayısını ve göz atma işlemini başlatmak için sıra numarasını belirtmenize olanak tanır.

  1. Gelişmiş seçenekler içeren iletilere göz atmak için Service Bus Gezgini açılan listesinde Göz Atma Modu'nu seçin.

    Screenshot of dropdown with Peek Mode selected for peek with advanced options.

  2. Göz atmak için Etkin İletiler veya Teslim Edilemeyen İletiler olup olmadığını görmek için ölçümleri denetleyin ve Kuyruk / Abonelik veya DeadLetter alt sırasını seçin.

    Screenshot of queue and dead-letter subqueue tabs with message metrics displayed for peek with advanced options.

  3. Seçeneklerle göz at düğmesini seçin. Göz atılması gereken ileti sayısını ve göz atma işleminin başlayacağı sıra numarasını belirtin ve Göz at düğmesini seçin.

    Screenshot indicating the Peek with options button, and a page where the options can be set.

  4. Göz atma işlemi tamamlandıktan sonra, iletiler aşağıdaki görüntüde gösterildiği gibi kılavuzda gösterilir. Belirli bir iletinin ayrıntılarını görüntülemek için kılavuzdan seçin. Gövdeyi veya ileti özelliklerini görüntülemeyi seçebilirsiniz.

    Screenshot with overview of peeked messages and message body content shown for peek with advanced options.

    Meta verileri görmek için alt bölmedeki İleti Özellikleri sekmesine geçin.

    Screenshot with overview of peeked messages and message properties shown for peek with advanced options.

    Dekont

    Göz atma yıkıcı bir işlem olmadığından ileti kuyruktan kaldırılmaz .

İleti alma

Service Bus Gezgini'nin receive işlevi, bir kuyruktan veya abonelikten ileti almaya izin verir.

  1. İletileri almak için Service Bus Gezgini açılan listesinde Alma Modu'nu seçin.

    Screenshot of dropdown with Receive Mode selected.

  2. Alacak Etkin İletiler veya Teslim Edilemeyen İletiler olup olmadığını görmek için ölçümleri denetleyin ve Kuyruk / Abonelik veya Ölü İletiler'i seçin.

    Screenshot of queue and dead-letter subqueue tabs with message metrics displayed for receive mode.

  3. İleti al düğmesini seçin ve alma modunu, alınacak ileti sayısını ve iletinin bekleneceğini en uzun süreyi belirtin ve Al'ı seçin.

    Screenshot indicating the Receive button, and a page where the options can be set.

    Önemli

    ReceiveAndDelete modunun yıkıcı bir alma olduğunu, örneğin iletinin Service Bus Gezgini aracında görüntülendiğinde kuyruktan kaldırıldığını lütfen unutmayın.

    kuyruktan kaldırmadan iletilere göz atmak için Göz atma işlevini veya PeekLock alma modunu kullanmayı göz önünde bulundurun.

  4. Alma işlemi tamamlandıktan sonra, iletiler aşağıdaki görüntüde gösterildiği gibi kılavuzda gösterilir. Belirli bir iletinin ayrıntılarını görüntülemek için kılavuzda seçin.

    Screenshot with overview of received messages and message body content shown.

    Screenshot with overview of received messages and message properties shown.

    Dekont

    Performans nedenleriyle, en fazla ileti boyutu 1 MB'ın üzerinde ayarlanmış olan bir kuyruktan veya abonelikten ileti alınırken, aynı anda yalnızca bir ileti alınır. İleti gövdesi 1 MB'ın üzerindeyse, görüntülenmeden önce kesilir.

PeekLock modunda bir ileti alındıktan sonra, bu ileti üzerinde gerçekleştirebileceğimiz çeşitli eylemler vardır.

Dekont

Bu eylemleri yalnızca iletide bir kilidimiz olduğu sürece gerçekleştirebiliriz.

İletiyi tamamlama

  1. Kılavuzda, tamamlamak istediğimiz alınan iletileri seçin.

  2. Tamamla düğmesini seçin.

    Screenshot indicating the Complete button.

    Önemli

    İletinin tamamlanmasının yıkıcı bir alma olduğunu, yani Service Bus Gezgini aracında Tamamlandı seçildiğinde iletinin kuyruktan kaldırıldığını lütfen unutmayın.

İletiyi erteleme

  1. Kılavuzda, ertelemek istediğimiz alınan iletileri seçin.

  2. Ertele düğmesini seçin.

    Screenshot indicating the Defer button.

Kilidi bırakma

  1. Kılavuzda, kilidi bırakmak istediğimiz alınan iletileri seçin.

  2. Kilidi bırak düğmesini seçin.

    Screenshot indicating the Abandon Lock button.

Kilit bırakıldıktan sonra, ileti alma işlemleri için yeniden kullanılabilir.

Teslim edilemeyen harf

  1. Kılavuzda, teslim edilmemesini istediğimiz alınan iletileri seçin.

  2. Teslim edilemeyen harf düğmesini seçin.

    Screenshot indicating the Dead-letter button.

Bir ileti geçersiz harfle yazıldıktan sonra, Teslim Edilemeyen harf alt sırasında kullanılabilir.

Kuyruğa veya konuya ileti gönderme

Kuyruğa veya konuya ileti göndermek için Service Bus Gezgini'nin İleti gönder düğmesini seçin.

  1. Metin/Düz, Uygulama/Xml veya Uygulama/Json olmak için İçerik Türü'nü seçin.

  2. İleti gövdesi için ileti içeriğini ekleyin. Daha önce ayarlanan İçerik Türü ile eşleştiğinden emin olun.

  3. Aracı özelliklerini ayarlama (isteğe bağlı) - Bunlar Bağıntı Kimliği, İleti Kimliği, Yanıtla, Etiket/Konu, Yaşam Süresi (TTL) ve Zamanlanmış Sıralama Saati (Zamanlanmış İletiler için) içerir.

  4. Özel Özellikleri ayarlama (isteğe bağlı) - bunlar bir sözlük anahtarına göre ayarlanan herhangi bir kullanıcı özelliği olabilir.

  5. Aynı iletiyi birden çok kez göndermek için Göndermeyi yinele'yi işaretleyin. İleti Kimliği ayarlanmamışsa, otomatik olarak sıralı değerlerle doldurulur.

  6. İleti oluşturulduktan sonra Gönder düğmesini seçin.

    Screenshot showing the compose message experience.

  7. Gönderme işlemi başarıyla tamamlandığında aşağıdakilerden biri gerçekleşir:

    • Kuyruğa gönderiliyorsa, Etkin İletiler ölçüm sayacı artar.
    • Bir konuya gönderiliyorsa, iletinin yönlendirildiği Aboneliklerde Etkin İletiler ölçüm sayacı artar.

İletiyi yeniden gönderme

bir iletiye göz atdıktan veya aldıktan sonra, iletinin içeriğini ve özelliklerini güncelleştirmemize olanak tanıyarak iletinin bir kopyasını aynı varlığa gönderecek şekilde yeniden gönderebiliriz. Özgün dosya kalır ve yeniden gönderildiğinde bile yeniden gönderilmeyen kuyruktan silinmez.

  1. Kılavuzda, yeniden göndermek istediğimiz iletileri seçin.

  2. Seçili iletileri yeniden gönder düğmesini seçin.

    Screenshot indicating the Resend selected messages button.

  3. İsteğe bağlı olarak, ayrıntılarını güncelleştirmek ve istenen değişiklikleri yapmak istediğimiz iletiyi seçin.

  4. İletileri varlığa göndermek için Gönder düğmesini seçin.

    Screenshot showing the resend messages experience.

    Dekont

    • Yeniden gönderme işlemi özgün iletinin bir kopyasını gönderir. Yeniden gönderdiğiniz özgün iletiyi kaldırmaz.
    • Aboneliğin teslim edilemeyen bir kuyruğunda bir iletiyi yeniden gönderirseniz, iletinin bir kopyası konuya gönderilir. Bu nedenle, tüm abonelikler iletinin bir kopyasını alır.

Kimlik doğrulama türünü değiştirme

Service Bus Gezgini ile çalışırken Erişim Anahtarı veya Microsoft Entra Id kimlik doğrulaması kullanmak mümkündür.

  1. Ayarlar düğmesini seçin.

    Screenshot indicating the Settings button in Service Bus Explorer.

  2. İstediğiniz kimlik doğrulama yöntemini seçin ve Kaydet düğmesini seçin.

    Screenshot indicating the Settings button and a page showing the different authentication types.

Sonraki Adımlar