Hızlı Başlangıç: Azure Event Hubs ile büyük iletiler gönderme ve alma (önizleme)

Bu hızlı başlangıçta, Azure Event Hubs kullanarak büyük iletileri (20 MB'a kadar) göndermeyi ve almayı öğreneceksiniz. Event Hubs'ı kullanmaya yeni başlamanız durumunda bu hızlı başlangıç için bkz . Event Hubs'a genel bakış .

Önkoşullar

Bu hızlı başlangıcı tamamlamak için aşağıdaki önkoşullara ihtiyacınız vardır:

• Azure aboneliği. Event Hubs da dahil olmak üzere Azure hizmetlerini kullanmak için bir aboneliğe ihtiyacınız vardır. Mevcut bir Azure hesabınız yoksa ücretsiz deneme sürümüne kaydolabilir veya hesap oluştururken MSDN abone avantajlarınızı kullanabilirsiniz.
• Self servis ölçeklenebilir ayrılmış küme, olay hub'ları ad alanı ve olay hub'ı. Bu önkoşulu karşılamanın ilk adımı, Azure portalını kullanarak küme içinde ayrılmış bir küme ve ad alanı oluşturmaktır. Olay hub'ı oluşturmak için bkz . Hızlı Başlangıç: Azure portalını kullanarak olay hub'ı oluşturma. Zaten bir self servis ölçeklenebilir ayrılmış kümeniz varsa bu adımı atlayabilirsiniz.

Not

Şu anda genel önizleme aşamasında olan büyük ileti desteği, belirli Event Hubs self servis ayrılmış kümelerle özel olarak kullanılabilir. Bu kümelerle büyük iletilerin akışının gerçekleştirilmesi ek ücret ödemez.

Event Hubs ayrılmış kümesini yapılandırma

Büyük iletilerin akışını yapmak için self servis ölçeklenebilir ayrılmış kümenizi yapılandırmanız gerekir.

Azure portalında, ayrılmış kümenin Ayarlar bölümüne gidin. Ayarlar'ın altında Kota sekmesini seçin.

• Salt okunur anahtarın supportslargemessages değerinin olarak Trueayarlandığını doğrulayın.
• Anahtarı eventhubmaxmessagesizeinbytes bayt cinsinden uygun bir değere güncelleştirebilirsiniz. Bu değer için kabul edilebilir bir aralık 1.048.576 ile 20.971.520 bayt arasındadır.

Yapılandırma kaydedildikten sonra Event Hubs ile büyük iletilerin akışını yapmaya hazırsınız demektir.

Önemli

Büyük ileti akışı yalnızca en son altyapıdan oluşturulmuş self servis ölçeklenebilir ayrılmış kümelerle desteklenir. Bu özellik anahtar tarafından Supportslargemessages yansıtılır.

Bir küme değeri false ise, büyük ileti akışını desteklemez. Bu özelliği etkinleştirmek için kümeyi yeniden oluşturmanız gerekir.

Event Hubs ile büyük iletilerin akışını oluşturma

Event Hubs, hem toplu olarak hem de tek tek yayınlar olarak 20 MB'a kadar büyük iletilerin akışını sağlar. Büyük iletilerin veya olayların akışla aktarılabilmesi için iletideki veya olayın kendisindeki değişiklik dışında hiçbir istemci kodu değişikliği gerekmez. Büyük iletileri Event Hubs'a akışla aktarmak için mevcut Event Hubs SDK'sını veya Kafka API'sini kullanarak ileti göndermeye veya almaya devam edebilirsiniz. Bu şekilde, büyük iletileri Event Hubs'a 1 MB'tan küçük iletiler için yaptığınız gibi akışla aktarabilirsiniz.

Daha fazla bilgi için bkz . .NET kullanarak Event Hubs'a olay gönderme ve olay alma.

İpucu

Event Hubs'a akışla aktardığınız ileti boyutu üst sınırını sınırlayan Event Hubs Gelişmiş İleti Kuyruğa Alma Protokolü (AMQP) istemcisini veya Kafka istemci yapılandırmasını gözden geçirmeyi unutmayın. Büyük iletilerin akışını yapmak için istemci zaman aşımını daha yüksek bir değere güncelleştirmeniz gerekir.

Varsayılan olarak, AMQP istemci ön yükleme sayısı 300'dür. Büyük iletilerle uğraşırken istemci tarafı bellek sorunlarını önlemek için bu değeri düşürebilirsiniz.

.NET kitaplık başvurusunun tamamı için SDK belgelerine bakın.