From eee221c7ee9cafb8198ff3ea57f087f3d2b3fdf7 Mon Sep 17 00:00:00 2001 From: Remi Gacogne Date: Tue, 25 Oct 2022 14:23:04 +0200 Subject: [PATCH] auth: Document that `consistent-backends` should not be used with scoped records --- docs/settings.rst | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/docs/settings.rst b/docs/settings.rst index b02952d83f..7fb2db3919 100644 --- a/docs/settings.rst +++ b/docs/settings.rst @@ -325,10 +325,15 @@ Name of this virtual configuration - will rename the binary image. See .. versionadded:: 4.4.0 When this is set, PowerDNS assumes that any single zone lives in only one backend. -This allows PowerDNS to send ANY lookups to its backends, instead of sometimes requesting the exact needed type. +This allows PowerDNS to send ``ANY`` lookups to its backends, instead of sometimes requesting the exact needed type. This reduces the load on backends by retrieving all the types for a given name at once, adding all of them to the cache. It improves performance significantly for latency-sensitive backends, like SQL ones, where a round-trip takes serious time. +.. warning:: + This behaviour is only a meaningful optimization if the returned response to the ``ANY`` query can actually be cached, + which is not the case if it contains at least one record with a non-zero scope. For this reason ``consistent-backends`` + should be disabled when at least one of the backends in use returns location-based records, like the GeoIP backend. + .. note:: Pre 4.5.0 the default was no. -- 2.47.2