Apache Cassandra işlemleri için Azure Cosmos DB'de hız sınırlama hatalarını önleme

  • Makale

ŞUNLAR IÇIN GEÇERLIDIR: Cassandra

Tüm veritabanı işlemlerinin maliyeti Azure Cosmos DB tarafından normalleştirilir ve İstek Birimleri (RU) ile ifade edilir. İstek birimi, Azure Cosmos DB tarafından desteklenen veritabanı işlemlerini gerçekleştirmek için gereken CPU, IOPS ve bellek gibi sistem kaynaklarını soyutlayan bir performans para birimidir.

Apache Cassandra için Azure Cosmos DB işlemleri, tablonun aktarım hızı sınırını (RU) aşarsa hız sınırlama (OverloadedException/429) hatalarıyla başarısız olabilir. Bu, burada açıklandığı gibi istemci tarafından işlenebilir. İstemci yeniden deneme ilkesi hız sınırlama hatası nedeniyle hatayı işlemek için uygulanamıyorsa, bir tablonun aktarım hızı sınırını aşan işlemlerin kısa bir gecikmeden sonra otomatik olarak yeniden deneneceği Sunucu tarafı yeniden deneme (SSR) özelliğini kullanabiliriz. Bu bir hesap düzeyi ayarıdır ve hesaptaki tüm Anahtar alanları ve Tablolar için geçerlidir.

Azure portalını kullanma

  1. Azure Portal’ında oturum açın.

  2. Apache Cassandra için Azure Cosmos DB hesabınıza gidin.

  3. Ayarlar bölümünün altındaki Özellikler bölmesine gidin.

  4. Sunucu Tarafı Yeniden Dene'yi seçin.

  5. Hesabınızdaki tüm koleksiyonlarda bu özelliği etkinleştirmek için Etkinleştir'e tıklayın.

Apache Cassandra için Azure Cosmos DB'ye yönelik sunucu tarafı yeniden deneme özelliğinin ekran görüntüsü

Azure CLI kullanma

  1. Hesabınız için SSR'nin zaten etkin olup olmadığını denetleyin:

    az cosmosdb show --name accountname --resource-group resourcegroupname

  2. Etkinleştirmek Veritabanı hesabınızdaki tüm tablolar için SSR. Bu değişikliğin etkili olması 15 dakika kadar sürebilir.

    az cosmosdb update --name accountname --resource-group resourcegroupname --capabilities EnableCassandra DisableRateLimitingResponses

  3. Aşağıdaki komut, yetenek listesinden kaldırarak DisableRateLimitingResponses veritabanı hesabınızdaki tüm tablolar için sunucu tarafı yeniden denemesini devre dışı bırakır. Bu değişikliğin etkili olması 15 dakika kadar sürebilir.

    az cosmosdb update --name accountname --resource-group resourcegroupname --capabilities EnableCassandra

Sık sorulan sorular

İstekler nasıl yeniden deneniyor?

İstekler, 60 saniyelik zaman aşımına ulaşılana kadar sürekli (tekrar tekrar) yeniden deneniyor. Zaman aşımına ulaşılırsa istemci buna göre okuma veya yazma zaman aşımı hatası alır

SSR ne zaman en faydalıdır?

Sunucu tarafı yeniden denemesi (SSR) en çok azaltma hatalarının önlenebileceği 1 dakikadan kısa bir süre boyunca ani bir artış olduğunda faydalıdır. İş yükü artmışsa ve belirtilen RU'nun üzerinde sürekli olarak kalacaksa, SSR çok fazla yardımcı olmayacaktır. Öneri, RU'ları uygun şekilde artırmaktır.

Önerilen istemci tarafı ayarları?

SSR etkinleştirildikten sonra istemci uygulaması, sunucu yeniden deneme 60 saniye ayarının ötesinde okuma zaman aşımını artırmalıdır. Daha güvenli bir tarafta olmak için 90 saniye öneririz.

Kod Örneği Sürücüsü3

SocketOptions socketOptions = new SocketOptions()
	.setReadTimeoutMillis(90000);

Kod Örneği Sürücüsü4

ProgrammaticDriverConfigLoaderBuilder configBuilder = DriverConfigLoader.programmaticBuilder()
	.withDuration(DefaultDriverOption.REQUEST_TIMEOUT, Duration.ofSeconds(90));

Sunucu tarafı yeniden denemesinin etkilerini nasıl izleyebilirim?

Yeniden denenen hız sınırlama hatalarını (429) Azure Cosmos DB Ölçümleri bölmesinde görüntüleyebilirsiniz. Bu hatalar SSR etkinleştirildiğinde istemciye gitmez, çünkü bunlar sunucu tarafında işlenir ve yeniden denener.

Azure Cosmos DB kaynak günlüklerinizdetahminiDelayFromRateLimitingInMilliseconds içeren günlük girdilerini arayabilirsiniz.

Sunucu tarafı yeniden denemesi tutarlılık düzeyimi etkileyecek mi?

Sunucu tarafı yeniden denemesi tutarlılık düzeylerini etkilemez. İstekler hız sınırlıysa sunucu tarafında yeniden deneniyor (Hata 429).

Sunucu tarafı yeniden denemesi, istemcimin alabileceği herhangi bir hata türünü etkiler mi?

Hayır, sunucu tarafı yeniden denemesi yalnızca sunucu tarafında yeniden denenerek hız sınırlama hatalarını (429) etkiler. Bu özellik, istemci uygulamasında hız sınırlama hatalarını işlemeniz gerekmesini önler. Diğer tüm hatalar istemciye gider.

Sonraki adımlar

Yaygın hataları giderme hakkında daha fazla bilgi edinmek için şu makaleye bakın:

Azure Cosmos DB'de aktarım hızı sağlama hakkında bilgi edinmek için aşağıdaki makalelere bakın: